<html>
  <head>
	  <meta http-equiv="content-type" content="text/html; charset=utf-8" />
    <title>i5ting_ztree_toc:api3</title>
		<link href="toc/style/github-bf51422f4bb36427d391e4b75a1daa083c2d840e.css" media="all" rel="stylesheet" type="text/css"/>
		<link href="toc/style/github2-d731afd4f624c99a4b19ad69f3083cd6d02b81d5.css" media="all" rel="stylesheet" type="text/css"/>
		<link href="toc/css/zTreeStyle/zTreeStyle.css" media="all" rel="stylesheet" type="text/css"/>
	  <style>
		pre {
		    counter-reset: line-numbering;
		    border: solid 1px #d9d9d9;
		    border-radius: 0;
		    background: #fff;
		    padding: 0;
		    line-height: 23px;
		    margin-bottom: 30px;
		    white-space: pre;
		    overflow-x: auto;
		    word-break: inherit;
		    word-wrap: inherit;
		}

		pre a::before {
		  content: counter(line-numbering);
		  counter-increment: line-numbering;
		  padding-right: 1em; /* space after numbers */
		  width: 25px;
		  text-align: right;
		  opacity: 0.7;
		  display: inline-block;
		  color: #aaa;
		  background: #eee;
		  margin-right: 16px;
		  padding: 2px 10px;
		  font-size: 13px;
		  -webkit-touch-callout: none;
		  -webkit-user-select: none;
		  -khtml-user-select: none;
		  -moz-user-select: none;
		  -ms-user-select: none;
		  user-select: none;
		}

		pre a:first-of-type::before {
		  padding-top: 10px;
		}

		pre a:last-of-type::before {
		  padding-bottom: 10px;
		}

		pre a:only-of-type::before {
		  padding: 10px;
		}

		.highlight { background-color: #ffffcc } /* RIGHT */
		</style>
  </head>
  <body>
	  <div>
				<div style='width:25%;'>
						<ul id="tree" class="ztree" style='width:100%'>

						</ul>
				</div>
        <div id='readme' style='width:70%;margin-left:20%;'>
          	<article class='markdown-body'>
            	<h1 id="-">登录注册及个人中心</h1>
<h2 id="-sun-wu-">登录注册(Sun Wu)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>编辑查询</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/login</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>公共请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>type</td>
<td>是</td>
<td>否</td>
<td>登陆方式(0-&gt;验证码登录(主账号);1-&gt;密码登录(子账号);2-&gt;主账号密码登录)</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>device</td>
<td>是</td>
<td>否</td>
<td>当前登陆设备(1-安卓 2-ios 3-pc 4-微信小程序 5-抖音小程序)</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>mini_code</td>
<td>否</td>
<td>否</td>
<td>code(获取微信openid）</td>
<td>string</td>
<td>222222</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>type 0</code> 请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>mobile</td>
<td>是</td>
<td>否</td>
<td>手机号</td>
<td>string</td>
<td>1895555555</td>
</tr>
<tr>
<td>code</td>
<td>是</td>
<td>否</td>
<td>验证码</td>
<td>string</td>
<td>222222</td>
</tr>
<tr>
<td>bind_id</td>
<td>否</td>
<td>否</td>
<td>分享者id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>device_id</td>
<td>否</td>
<td>否</td>
<td>设备id</td>
<td>string</td>
<td>dvasdasv12edwd23</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>type 1</code> 请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>username</td>
<td>是</td>
<td>否</td>
<td>用户名</td>
<td>string</td>
<td>test</td>
</tr>
<tr>
<td>password</td>
<td>是</td>
<td>否</td>
<td>密码</td>
<td>string</td>
<td>123465</td>
</tr>
<tr>
<td>device_id</td>
<td>否</td>
<td>否</td>
<td>设备id</td>
<td>string</td>
<td>dvasdasv12edwd23</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>type 2</code> 请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>username</td>
<td>是</td>
<td>否</td>
<td>用户名</td>
<td>string</td>
<td>test</td>
</tr>
<tr>
<td>pwd</td>
<td>是</td>
<td>否</td>
<td>密码</td>
<td>string</td>
<td>123465</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注</p>
<pre><code>万能验证码为`666666`, 仅支持登录方式为主账号时使用，参数`device`正常传值即可
</code></pre></blockquote>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;user_id&quot;: 1,//用户id
        &quot;token&quot;: &quot;s1VuRi87NjmXmQViP6VQ8bl6rL3stOB10kI3D5UgUmFhm6XTBTrZIqC+vCGPZD9PC+dwQk+HtaegyKKqqGW5Xbd5ZtlVu5sZ66dLz4I84F2r/+1zIFWnXYSKkE+0RycXsFJ46Umq0iIIlX6bFDUyhC3CXzOlRp9iVBWiH/6Azzw=&quot;,//token
        &quot;company_name&quot;: &quot;&quot;//公司名称
        &quot;bind_id&quot;: 0,//绑定的分享者id
        &quot;invite_num&quot;: 4,//分享数(分享后成功注册数)
        &quot;parent_id&quot;:  1,//生成分享链接使用的分享id
        &quot;is_main&quot;: 1; //账号类型;0:子;1:主;
        &quot;nickname&quot;: &quot;子账号&quot;//公司名称
        &quot;invite_num&quot;: 0,//成功邀请次数
        &quot;bind_id&quot;: 0,//分享来源id
        &quot;is_default_pwd&quot;: 0,//是否有修改默认密码;0:否;1:是;(子账号登录时返回，主账号登录无此参数)
        &quot;is_bind_openid&quot;: 1,//是否有绑定微信或小程序:0:否;1:是;
        &quot;is_vip&quot;: 0,    //是否开通vip;0:否;1:是;2:vip体验中;
        &#39;is_set_as_supplier&#39;: 1,//是否将客户作为供应商使用;0:否;1:是;
        &quot;is_share_customer&quot;: 0,    //是否共享客户;0:否;1:是;
        &quot;invite_info&quot;: [
            &quot;18519122462&quot;,
            &quot;15505523456&quot;
        ],//通过分享邀请并成功注册的账号信息
        &quot;module_info&quot;: [
            {
                &quot;id&quot;: 1,//一级权限模块id
                &quot;module_name&quot;: &quot;系统设置&quot;,//一级权限模块名
                &quot;upper_module_id&quot;: 0,//上级权限模块id
                &quot;module_img&quot;: null,//权限模块图标
                &quot;type&quot;: &quot;&quot;,//类型
                &quot;sort&quot;: &quot;&quot;,//排序
                &quot;second_module&quot;: [
                    {
                        &quot;id&quot;: 2,//二权限模块id
                        &quot;module_name&quot;: &quot;模块管理&quot;,//二级权限模块名
                        &quot;upper_module_id&quot;: 1,//上级权限模块id
                        &quot;module_img&quot;: null,//权限模块图标
                        &quot;type&quot;: &quot;&quot;//类型
                        &quot;sort&quot;: &quot;&quot;,//排序
                    },
                    ......
                ]
            }
        ],
         &quot;field_list&quot;: [//字段权限列表
            &quot;cost&quot;,
            &quot;selling_price&quot;
        ]
    }
}

</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-08-18 16:40`:增加`field_list`返回 
`2022-08-05 17:13`:增加`is_vip`返回 
</code></pre></blockquote>
<h2 id="-sun-wu-">个人中心 (Sun Wu)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>个人中心</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/user_center</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 1216, //用户id
        &quot;username&quot;: &quot;15545436518&quot;,  //用户名(即登录使用账号)
        &quot;nickname&quot;: &quot;访客&quot;,   //用户昵称
        &quot;mobile&quot;: &quot;15545436518&quot;,    //手机号
        &quot;parent_id&quot;: 8, //父级id(主账号id)
        &quot;company_name&quot;: null,   //公司名称
        &quot;company_class&quot;: 0, //公司类型id
        &quot;is_active&quot;: 1, //是否启用;0:禁用;1:启用
        &quot;parent_id&quot;: 8,//生成分享链接所需要的分享者id标识
        &quot;bind_id&quot;: 1,//分享来源id
        &quot;is_default_pwd&quot;: 0,//是否有修改默认密码;0:否;1:是;(子账号登录时返回，主账号登录无此参数)
        &quot;invite_num&quot;: 0,//成功邀请次数
        &quot;name&quot;: null,   //公司类型名称
        &quot;is_main&quot;: 1, //账号类型;0:子;1:主;
        &quot;is_use_shelf&quot;: 1, //是否使貨架;0:否;1:是;
        &quot;is_bind_openid&quot;: 1,//是否有绑定微信或小程序:0:否;1:是;
        &quot;is_vip&quot;: 0,    //是否开通vip;0:否;1:是;2:VIP体验中;
        &quot;is_set_as_supplier&quot;:0,//是否将客户作为供应商使用;0:否;1:是;
        &quot;is_share_customer&quot;:0,//是否共享客户;0:否;1:是;
        &quot;account_storage&quot;: &quot;1.00&quot;,//可用存储空间(单位:M)
        &quot;file_total_size&quot;: &quot;0.09&quot;,//已用存储空间(单位:M)
        &quot;clear_watermark_or_not&quot;: 0,//去除水印，1是，0否
        &quot;is_in_experience&quot;:0,//是否开启体验;0:否;1:是;    
        &quot;is_end_experience&quot;:0,//体验是否到期;0:否;1:是;    
        &quot;is_share_express&quot;: 0,//是否共享快递信息;0:否;1:是;    
        &quot;is_first_charge&quot;: 0,//是否已经使用首次充值;0:否;1:是;
        &quot;is_use_serial&quot;: 0,//是否使用序列号;0:否;1:是;
        &quot;vip_end_date&quot;:0,//VIP到期时间
        &quot;wx_nickname&quot;: &quot;joker&quot;,//微信用户昵称
        &quot;invite_info&quot;: [
            &quot;18519122462&quot;,
            &quot;15505523456&quot;
        ],//通过分享邀请并成功注册的账号信息
        &quot;today_in_storage&quot;: 10000,  //今日入库数
        &quot;today_out_storage&quot;: 10000, //今日出库数
        &quot;today_package&quot;: 10000, //套餐数量
        &quot;today_trans_storage&quot;: 10000,    //调拨数量
         &quot;field_list&quot;: [ //字段权限列表
            &quot;cost&quot;,
            &quot;selling_price&quot;
        ]
    }
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-09-06 11:00`:增加`account_storage`，`file_total_size`返回
`2022-09-01 13:45`:增加`is_use_shelf`，`is_main`返回
`2022-08-23 13:45`:增加`is_first_charge`返回
`2022-08-22 15:51`:增加`is_share_express`返回
`2022-08-18 16:40`:增加`field_list`返回 
`2022-08-17 15:13`:增加`vip_end_date`返回 
`2022-08-06 15:09`:增加`is_in_experience`、`is_end_experience`返回 
`2022-08-05 17:13`:增加`is_vip`、`is_set_as_supplier`、`is_share_customer`返回 
</code></pre></blockquote>
<blockquote>
<p>备注</p>
</blockquote>
<pre><code>体验到期后，`is_in_experience`不变，`is_end_experience`转变为1,表示体验到期
</code></pre><h1 id="-">调拨</h1>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>调拨</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/allocate</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>storage_id</td>
<td>是</td>
<td>否</td>
<td>调入仓库id</td>
<td>integer</td>
<td>529</td>
</tr>
<tr>
<td>allocate_info</td>
<td>是</td>
<td>否</td>
<td>调拨信息</td>
<td>json</td>
<td>[{&quot;id&quot;:20814,&quot;allocate_num&quot;:1,&quot;batch_info&quot;:[]},{&quot;id&quot;:34605,&quot;allocate_num&quot;:1,&quot;serial_info&quot;:[]}]</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>这是调拨</td>
</tr>
<tr>
<td>shelf_id</td>
<td>否</td>
<td>否</td>
<td>货架id</td>
<td>string</td>
<td>1</td>
</tr>
<tr>
<td>location_id</td>
<td>否</td>
<td>否</td>
<td>库位id</td>
<td>string</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>allocate_info</code>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>库存id</td>
<td>integer</td>
<td>20814</td>
</tr>
<tr>
<td>allocate_num</td>
<td>是</td>
<td>否</td>
<td>调拨数量</td>
<td>integer</td>
<td>100</td>
</tr>
<tr>
<td>serial_info</td>
<td>否</td>
<td>否</td>
<td>序列号信息</td>
<td>string</td>
<td>[{&quot;serial_id&quot;:1,&quot;num&quot;:1},......]</td>
</tr>
<tr>
<td>batch_info</td>
<td>否</td>
<td>否</td>
<td>批次号信息</td>
<td>string</td>
<td>[{&quot;batch_id&quot;:1,&quot;num&quot;:1},......]</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>serial_info</code>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>serial_id</td>
<td>是</td>
<td>否</td>
<td>序列号id</td>
<td>integer</td>
<td>20814</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>序列号调拨数量</td>
<td>integer</td>
<td>100</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>batch_info</code>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>batch_id</td>
<td>是</td>
<td>否</td>
<td>批次号id</td>
<td>integer</td>
<td>20814</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>批次号调拨数量</td>
<td>integer</td>
<td>100</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注</p>
</blockquote>
<ul>
<li>商品信息<code>is_user_serial</code>未开启且未设置开启批次号，则使用普通调拨, 默认序列号优先级高于批次号;</li>
<li>货架未开启，<code>shelf_id</code>和<code>location_id</code>允许为空</li>
</ul>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h1 id="-">报溢报损</h1>
<h2 id="-">新建</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>新建</td>
<td>http</td>
<td>post</td>
<td>overflow_breakage_add</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>goods_info</td>
<td>是</td>
<td>否</td>
<td>商品信息</td>
<td>array</td>
<td>[{&quot;name&quot;:&quot;测试&quot;,&quot;type_name&quot;:&quot;规格&quot;,&quot;num&quot;:2,&quot;image&quot;:&quot;商品图片地址&quot;,&quot;warehouse&quot;:&quot;仓库名称&quot;,&quot;warehouse_id&quot;:1,&quot;remark&quot;:&quot;备注&quot;},{&quot;name&quot;:&quot;测试1&quot;,&quot;type_name&quot;:&quot;规格&quot;,&quot;num&quot;:22,&quot;image&quot;:&quot;商品图片地址&quot;,&quot;warehouse&quot;:&quot;仓库名称1&quot;,&quot;warehouse_id&quot;:2,&quot;remark&quot;:&quot;备注&quot;}]</td>
</tr>
<tr>
<td>proof_image</td>
<td>否</td>
<td>否</td>
<td>凭证图片(多图逗号分隔)</td>
<td>string</td>
<td>test.png,tes4.png</td>
</tr>
<tr>
<td>check_info</td>
<td>是</td>
<td>否</td>
<td>审批人信息</td>
<td>array</td>
<td>[{&quot;id&quot;:1,&quot;name&quot;:&quot;名字&quot;,&quot;mobile&quot;:&quot;手机号&quot;},{&quot;id&quot;:2,&quot;name&quot;:&quot;名字1&quot;,&quot;mobile&quot;:&quot;手机号1&quot;}]</td>
</tr>
<tr>
<td>type</td>
<td>是</td>
<td>否</td>
<td>类型：0-报溢 1-报损</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>package_info</td>
<td>是</td>
<td>否</td>
<td>套餐信息</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注</p>
</blockquote>
<pre><code>报溢单无套餐信息
</code></pre><blockquote>
<p>goods_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>materiel_type_id</td>
<td>是</td>
<td>否</td>
<td>商品关联id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>name</td>
<td>是</td>
<td>否</td>
<td>商品名称</td>
<td>string</td>
<td>保温箱</td>
</tr>
<tr>
<td>type_name</td>
<td>是</td>
<td>否</td>
<td>型号</td>
<td>string</td>
<td>大保温箱</td>
</tr>
<tr>
<td>shelf_id</td>
<td>是</td>
<td>否</td>
<td>货架</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>shelf_location_id</td>
<td>是</td>
<td>否</td>
<td>库位</td>
<td>integer</td>
<td>2</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>image</td>
<td>是</td>
<td>否</td>
<td>商品图片</td>
<td>string</td>
<td>1.png</td>
</tr>
<tr>
<td>warehouse_id</td>
<td>是</td>
<td>否</td>
<td>仓库id</td>
<td>integer</td>
<td>仓库id</td>
</tr>
<tr>
<td>warehouse</td>
<td>是</td>
<td>否</td>
<td>仓库名称</td>
<td>string</td>
<td>1号仓库</td>
</tr>
<tr>
<td>remark</td>
<td>是</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>丢失</td>
</tr>
<tr>
<td>materiel_no</td>
<td>否</td>
<td>否</td>
<td>编号</td>
<td>string</td>
<td>452342345</td>
</tr>
<tr>
<td>serial_number</td>
<td>否</td>
<td>否</td>
<td>序列号</td>
<td>string</td>
<td>45234234,1231321</td>
</tr>
<tr>
<td>batch_info</td>
<td>否</td>
<td>否</td>
<td>批次号(报溢无批次)</td>
<td>string</td>
<td>&quot;batch_info&quot;:[{&quot;batch_id&quot;:33,&quot;storage_manage_id&quot;:10048,&quot;num&quot;:2}....]</td>
</tr>
</tbody>
</table>
<blockquote>
<p>check_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>用户id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>name</td>
<td>是</td>
<td>否</td>
<td>用户昵称(nickname)</td>
<td>string</td>
<td>掌上网络</td>
</tr>
<tr>
<td>mobile</td>
<td>是</td>
<td>否</td>
<td>用户账号名(username)</td>
<td>string</td>
<td>13911557144</td>
</tr>
</tbody>
</table>
<blockquote>
<p>package_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>package_id</td>
<td>是</td>
<td>否</td>
<td>套餐id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>package_content</td>
<td>是</td>
<td>否</td>
<td>套餐id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>remark</td>
<td>是</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>丢失</td>
</tr>
</tbody>
</table>
<blockquote>
<p>package_content</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>type_id</td>
<td>是</td>
<td>否</td>
<td>商品id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>套餐内商品数量</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>storage_id</td>
<td>是</td>
<td>否</td>
<td>仓库id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>storage_manage_id</td>
<td>是</td>
<td>否</td>
<td>库存id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>shelf_id</td>
<td>是</td>
<td>否</td>
<td>货架</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>shelf_location_id</td>
<td>是</td>
<td>否</td>
<td>库位</td>
<td>integer</td>
<td>2</td>
</tr>
<tr>
<td>serial_number</td>
<td>否</td>
<td>否</td>
<td>序列号</td>
<td>string</td>
<td>45234234,1231321</td>
</tr>
<tr>
<td>batch_info</td>
<td>否</td>
<td>否</td>
<td>批次号</td>
<td>string</td>
<td>&quot;batch_info&quot;:[{&quot;batch_id&quot;:33,&quot;storage_manage_id&quot;:10048,&quot;num&quot;:2}....]</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-09-14 21:25`:增加请求参数`batch_info`
`2022-09-01 21:25`:增加请求参数`serial_number`
`2022-08-30 16:58`:增加请求参数`shelf_id`,`shelf_location_id`
</code></pre><h2 id="-">列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>列表</td>
<td>http</td>
<td>post</td>
<td>overflow_breakage_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>页面大小</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>页码</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>type</td>
<td>是</td>
<td>否</td>
<td>类型：0-报溢 1-报损</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>repeal_status</td>
<td>是</td>
<td>否</td>
<td>撤销状态：0-未撤销 1-已撤销 2-全部</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>status</td>
<td>是</td>
<td>否</td>
<td>审批状态(即入库状态):0-待审批 1-通过 2-拒绝 3-全部</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>否</td>
<td>关键词(可用于：商品名，型号名，商品编号，套餐名)</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>start_time</td>
<td>否</td>
<td>否</td>
<td>开始时间</td>
<td>date</td>
<td>2022-04-15 13:15:22</td>
</tr>
<tr>
<td>end_time</td>
<td>否</td>
<td>否</td>
<td>结束时间</td>
<td>date</td>
<td>2022-04-15 13:15:22</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注</p>
</blockquote>
<pre><code>报溢单无套餐信息
</code></pre><blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
            {
                &quot;id&quot;: 6,    //报溢报损主单id
                &quot;main_id&quot;: 96,  //主账号id
                &quot;user_id&quot;: 96,  //操作人id
                &quot;status&quot;: 0,    //审批状态(即入库状态):0-待审批 1-通过 2-拒绝    
                &quot;proof_image&quot;: null,    //凭证图片(多图逗号分隔)
                &quot;type&quot;: 1,  //类型：0-报溢 1-报损
                &quot;repeal_status&quot;: 1, //撤销状态：0-未撤销 1-已撤销    
                &quot;created_at&quot;: &quot;2022-02-23 15:19:39&quot;,    //创建时间
                &quot;updated_at&quot;: &quot;2022-03-07 14:43:03&quot;,
                &quot;username&quot;: &quot;15267902931&quot;,  //
                &quot;nickname&quot;: &quot;访客&quot;,   //
                &quot;goods_info&quot;: [
                    {
                        &quot;id&quot;: 18,   //报溢报损单内商品id(非实际商品id)
                        &quot;materiel_type_id&quot;: 13300,  //商品id
                        &quot;name&quot;: &quot;德州苹果&quot;, //商品名称(废弃)
                        &quot;type_name&quot;: &quot;10cm&quot;,    //型号名
                        &quot;num&quot;: 2,   //报溢报损数量
                        &quot;image&quot;: &quot;/uploads/2022/05/12/mp7SBWdSvtLX6AvzmlFZhqwVoCNh68DtyDANrUQy.jpg&quot;,    //商品图
                        &quot;warehouse&quot;: &quot;仓库18&quot;,    //仓库名(废弃)
                        &quot;warehouse_id&quot;: 1828,   //仓库
                        &quot;serial_number&quot;: &quot;123,321&quot;,//序列号
                        &quot;remark&quot;: &quot;&quot;,   //报溢报损单内商品备注
                        &quot;main_id&quot;: 96,  //
                        &quot;o_b_main_id&quot;: 30,  //报溢报损主单id
                        &quot;materiel_no&quot;: &quot;0G5jp4hu&quot;,  //商品编号
                        &quot;created_at&quot;: &quot;2022-05-21 15:35:15&quot;,    //
                        &quot;updated_at&quot;: null, //
                        &quot;materiel_name&quot;: &quot;德州苹果&quot;,    //商品名
                        &quot;storage_name&quot;: &quot;仓库18&quot;, //仓库名
                        &quot;storage_address&quot;: &quot;jdj&quot;,    //仓库地址
                        &quot;is_use_serial&quot;:1,  //是否使用序列号;0:否;1:是;
                    }
                ],
                &quot;package_info&quot;: [
                    {
                        &quot;id&quot;: 13,   //报溢报损单内套餐id(非实际套餐id)
                        &quot;package_id&quot;: 52,   //套餐id
                        &quot;num&quot;: 22,  //套餐报溢报损数量
                        &quot;main_id&quot;: 96,  //
                        &quot;o_b_main_id&quot;: 26,  //报溢报损主单id
                        &quot;remark&quot;: &quot;&quot;,   //报溢报损单内套餐备注
                        &quot;created_at&quot;: &quot;2022-05-21 13:52:19&quot;,    //
                        &quot;updated_at&quot;: null,
                        &quot;package_name&quot;: &quot;老蓝，5L保温箱+温度显示+1蓝冰+6冰袋&quot;,    //套餐名
                        &quot;package_content&quot;: [
                            {
                                &quot;id&quot;: 13,   //报溢报损单内套餐内容id(非实际套餐内容id)
                                &quot;package_id&quot;: 52,   //套餐id
                                &quot;num&quot;: 22,  //报溢报损单内套餐所需商品数量
                                &quot;total_num&quot;: 220,   //报溢报损单套餐内容总商品数量(报溢报损单内套餐所需商品数量 * 套餐报溢报损数量)
                                &quot;o_b_p_id&quot;: 13, //报溢报损单内套餐id
                                &quot;storage_manage_id&quot;: 1843,  //库存id
                                &quot;type_id&quot;: 31,  //商品id
                                &quot;storage_id&quot;: 33,   //仓库id
                                &quot;o_b_id&quot;: 26,   //报溢报损主单id
                                &quot;main_id&quot;: 96,  //
                                &quot;serial_number&quot;: &quot;123,321&quot;,//序列号
                                &quot;batch_info&quot;: &quot;[{\&quot;batch_id\&quot;:33,\&quot;num\&quot;:2},{\&quot;batch_id\&quot;:32,\&quot;num\&quot;:3}]&quot;,//批次信息
                                &quot;created_at&quot;: &quot;2022-05-21 13:52:19&quot;,    //
                                &quot;updated_at&quot;: &quot;1970-01-01 08:00:00&quot;,
                                &quot;materiel_name&quot;: &quot;保温箱5L&quot;,   //商品名
                                &quot;type_name&quot;: &quot;5L&quot;,  //型号名
                                &quot;materiel_no&quot;: &quot;&quot;,  //商品编号
                                &quot;storage_name&quot;: &quot;B2-6&quot;, //仓库名
                                &quot;storage_address&quot;: &quot;b 2-6&quot;,  //仓库地址
                                &quot;is_use_serial&quot;:1,  //是否使用序列号;0:否;1:是;
                            }
                        ]
                    }
                ],
                &quot;check_info&quot;: [
                    {
                        &quot;id&quot;: 26,   //审批单id
                        &quot;o_b_main_id&quot;: 26,//报溢报损主单id
                        &quot;status&quot;: 0,    //审批状态：0-待审批 1-通过 2-拒绝    
                        &quot;name&quot;: &quot;名字&quot;,   //姓名    
                        &quot;mobile&quot;: &quot;手机号&quot;,    //手机号
                        &quot;admin_id&quot;: 96,
                        &quot;refund_remark&quot;: null,  //拒绝原因    
                        &quot;created_at&quot;: &quot;2022-05-21 13:52:19&quot;,
                        &quot;updated_at&quot;: null
                    }
                ]
            }
        ],
        ......
        &quot;total&quot;: 1
    }
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-09-09 10:25`:增加`is_use_serial`返回
`2022-09-01 21:25`:增加请求参数`serial_number`
</code></pre><h2 id="-">详细</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>详细</td>
<td>http</td>
<td>post</td>
<td>overflow_breakage_detail</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>页面大小</td>
<td>销售单id</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 6,    //报溢报损主单id
        &quot;main_id&quot;: 96,  //主账号id
        &quot;user_id&quot;: 96,  //操作人id
        &quot;status&quot;: 0,    //审批状态(即入库状态):0-待审批 1-通过 2-拒绝    
        &quot;proof_image&quot;: null,    //凭证图片(多图逗号分隔)
        &quot;type&quot;: 1,  //类型：0-报溢 1-报损
        &quot;repeal_status&quot;: 1, //撤销状态：0-未撤销 1-已撤销    
        &quot;created_at&quot;: &quot;2022-02-23 15:19:39&quot;,    //创建时间
        &quot;updated_at&quot;: &quot;2022-03-07 14:43:03&quot;,
        &quot;username&quot;: &quot;15267902931&quot;,  //
        &quot;nickname&quot;: &quot;访客&quot;,   //
        &quot;goods_info&quot;: [
            {
                &quot;id&quot;: 18,   //报溢报损单内商品id(非实际商品id)
                &quot;materiel_type_id&quot;: 13300,  //商品id
                &quot;name&quot;: &quot;德州苹果&quot;, //商品名称(废弃)
                &quot;type_name&quot;: &quot;10cm&quot;,    //型号名
                &quot;num&quot;: 2,   //报溢报损数量
                &quot;image&quot;: &quot;/uploads/2022/05/12/mp7SBWdSvtLX6AvzmlFZhqwVoCNh68DtyDANrUQy.jpg&quot;,    //商品图
                &quot;warehouse&quot;: &quot;仓库18&quot;,    //仓库名(废弃)
                &quot;warehouse_id&quot;: 1828,   //仓库
                &quot;remark&quot;: &quot;&quot;,   //报溢报损单内商品备注
                &quot;main_id&quot;: 96,  //
                &quot;serial_number&quot;: &quot;123,321&quot;,//序列号
                &quot;o_b_main_id&quot;: 30,  //报溢报损主单id
                &quot;materiel_no&quot;: &quot;0G5jp4hu&quot;,  //商品编号
                &quot;created_at&quot;: &quot;2022-05-21 15:35:15&quot;,    //
                &quot;updated_at&quot;: null, //
                &quot;materiel_name&quot;: &quot;德州苹果&quot;,    //商品名
                &quot;storage_name&quot;: &quot;仓库18&quot;, //仓库名
                &quot;storage_address&quot;: &quot;jdj&quot;    //仓库地址
                &quot;is_use_serial&quot;:1,  //是否使用序列号;0:否;1:是;
            }
        ],
        &quot;package_info&quot;: [
            {
                &quot;id&quot;: 13,   //报溢报损单内套餐id(非实际套餐id)
                &quot;package_id&quot;: 52,   //套餐id
                &quot;num&quot;: 22,  //套餐报溢报损数量
                &quot;main_id&quot;: 96,  //
                &quot;o_b_main_id&quot;: 26,  //报溢报损主单id
                &quot;remark&quot;: &quot;&quot;,   //报溢报损单内套餐备注
                &quot;created_at&quot;: &quot;2022-05-21 13:52:19&quot;,    //
                &quot;updated_at&quot;: null,
                &quot;package_name&quot;: &quot;老蓝，5L保温箱+温度显示+1蓝冰+6冰袋&quot;,    //套餐名
                &quot;package_content&quot;: [
                    {
                        &quot;id&quot;: 13,   //报溢报损单内套餐内容id(非实际套餐内容id)
                        &quot;package_id&quot;: 52,   //套餐id
                        &quot;num&quot;: 22,  //报溢报损单内套餐所需商品数量
                        &quot;total_num&quot;: 220,   //报溢报损单套餐内容总商品数量(报溢报损单内套餐所需商品数量 * 套餐报溢报损数量)
                        &quot;o_b_p_id&quot;: 13, //报溢报损单内套餐id
                        &quot;storage_manage_id&quot;: 1843,  //库存id
                        &quot;type_id&quot;: 31,  //商品id
                        &quot;storage_id&quot;: 33,   //仓库id
                        &quot;o_b_id&quot;: 26,   //报溢报损主单id
                        &quot;main_id&quot;: 96,  //
                        &quot;serial_number&quot;: &quot;123,321&quot;,//序列号
                        &quot;created_at&quot;: &quot;2022-05-21 13:52:19&quot;,    //
                        &quot;updated_at&quot;: &quot;1970-01-01 08:00:00&quot;,
                        &quot;batch_info&quot;: &quot;[{\&quot;batch_id\&quot;:33,\&quot;num\&quot;:2},{\&quot;batch_id\&quot;:32,\&quot;num\&quot;:3}]&quot;,//批次信息
                        &quot;materiel_name&quot;: &quot;保温箱5L&quot;,   //商品名
                        &quot;type_name&quot;: &quot;5L&quot;,  //型号名
                        &quot;materiel_no&quot;: &quot;&quot;,  //商品编号
                        &quot;storage_name&quot;: &quot;B2-6&quot;, //仓库名
                        &quot;storage_address&quot;: &quot;b 2-6&quot;  //仓库地址
                        &quot;is_use_serial&quot;:1,  //是否使用序列号;0:否;1:是;
                    }
                ]
            }
        ],
        &quot;check_info&quot;: [
            {
                &quot;id&quot;: 26,   //审批单id
                &quot;o_b_main_id&quot;: 26,//报溢报损主单id
                &quot;status&quot;: 0,    //审批状态：0-待审批 1-通过 2-拒绝    
                &quot;name&quot;: &quot;名字&quot;,   //姓名    
                &quot;mobile&quot;: &quot;手机号&quot;,    //手机号
                &quot;admin_id&quot;: 96,
                &quot;refund_remark&quot;: null,  //拒绝原因    
                &quot;created_at&quot;: &quot;2022-05-21 13:52:19&quot;,
                &quot;updated_at&quot;: null
            }
        ]
    }
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-09-09 10:25`:增加`is_use_serial`返回
`2022-09-01 21:25`:增加请求参数`serial_number`
</code></pre><h1 id="-vip-">开启vip体验</h1>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>开启vip体验</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/start_to_experience</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h1 id="-">供应商客户管理</h1>
<h2 id="-sun-wu-">添加(Sun Wu)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>添加</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/supplier_customer_add</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>compony_name</td>
<td>是</td>
<td>否</td>
<td>公司名称</td>
<td>string</td>
<td>宏牧科技</td>
</tr>
<tr>
<td>name</td>
<td>是</td>
<td>否</td>
<td>客户\供应商名称</td>
<td>string</td>
<td>杨总</td>
</tr>
<tr>
<td>phone</td>
<td>是</td>
<td>否</td>
<td>联系方式(多个用英文逗号分隔)</td>
<td>string</td>
<td>18955333312,12243243543,2345124434</td>
</tr>
<tr>
<td>home_phone</td>
<td>否</td>
<td>否</td>
<td>固定电话</td>
<td>string</td>
<td>0552-14312421341234</td>
</tr>
<tr>
<td>address</td>
<td>是</td>
<td>否</td>
<td>地址</td>
<td>string</td>
<td>安徽</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>我是黄金客户</td>
</tr>
<tr>
<td>type</td>
<td>是</td>
<td>否</td>
<td>类型：0-供应商 1-客户</td>
<td>integer</td>
<td>0</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: 1 //新增id
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-08-05 17:13`:增加请求参数`type`、增加请求参数`home_phone`、增加请求参数`remark`、请求参数`phone` 可以传多个、
</code></pre></blockquote>
<h2 id="-sun-wu-">编辑(Sun Wu)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>编辑</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/supplier_customer_edit</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>供应商客户主键id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>compony_name</td>
<td>否</td>
<td>否</td>
<td>公司名称</td>
<td>string</td>
<td>宏牧科技</td>
</tr>
<tr>
<td>name</td>
<td>否</td>
<td>否</td>
<td>客户\供应商名称</td>
<td>string</td>
<td>杨总</td>
</tr>
<tr>
<td>phone</td>
<td>否</td>
<td>否</td>
<td>联系方式</td>
<td>string</td>
<td>18955333312</td>
</tr>
<tr>
<td>address</td>
<td>否</td>
<td>否</td>
<td>地址</td>
<td>string</td>
<td>安徽</td>
</tr>
<tr>
<td>type</td>
<td>否</td>
<td>否</td>
<td>类型：0-供应商 1-客户</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>我是黄金客户</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-08-05 17:13`:请求参数增加：`type`、`home_phone`、`phone`、`remark`
</code></pre></blockquote>
<h2 id="-sun-wu-">批量删除(Sun Wu)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>删除</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/supplier_customer_del</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>ids</td>
<td>是</td>
<td>否</td>
<td>供应商客户主键id (多个用英文逗号分隔)</td>
<td>integer</td>
<td>1,2,3</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-sun-wu-">列表(Sun Wu)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/supplier_customer_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>页面大小</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>当前页</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>name</td>
<td>否</td>
<td>否</td>
<td>搜索（客户\供应商名称 ）</td>
<td>string</td>
<td>孙</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,      当前页
        &quot;data&quot;: [
            {
                &quot;id&quot;: 5,    供应商客户主键id
                &quot;compony_name&quot;: &quot;红木科技&quot;,     公司名称
                &quot;name&quot;: &quot;孙先生&quot;,      客户\供应商名称
                &quot;phone&quot;:  [
                    &quot;21433214&quot;,
                    &quot;2314341&quot;,
                    &quot;354345&quot;
                ],    联系方式
                &quot;address&quot;: &quot;星宇科技园&quot;,     地址
                &quot;type&quot;: 1,     类型：0-供应商 1-客户
                &quot;created_at&quot;: &quot;2021-10-14 15:41:05&quot;,    创建时间
                &quot;username&quot;: &quot;15505523456&quot;   操作人
            }
        ],
        &quot;per_page&quot;: &quot;5&quot;,    页面大小
    }
}
</code></pre><h2 id="-sun-wu-">下拉框(Sun Wu)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/supplier_customer_select</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>type</td>
<td>是</td>
<td>否</td>
<td>类型：0-销售单侧 1-采购单侧</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>否</td>
<td>搜索（客户\供应商名称 ）</td>
<td>string</td>
<td>孙</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: [
        {
            &quot;id&quot;: 3,    供应商客户主键id
            &quot;name&quot;: &quot;严总&quot;    客户\供应商名称
             &quot;phone&quot;:  [
                    &quot;21433214&quot;,
                    &quot;2314341&quot;,
                    &quot;354345&quot;
                ],手机号
        },
        {
            &quot;id&quot;: 5,
            &quot;name&quot;: &quot;孙先生&quot;
             &quot;phone&quot;:  [
                    &quot;21433214&quot;,
                    &quot;2314341&quot;,
                    &quot;354345&quot;
                ],手机号
        }
    ]
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-08-05 17:13`:调整参数`type`从原本的客户或供应商类型选择为具体的使用场景(销售单或采购单) 
`2022-09-21 16:55`:添加请求参数字段`keyword`
</code></pre></blockquote>
<h1 id="-">系统维护设置</h1>
<h2 id="-">开启系统维护</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/set_is_upkeep</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: 1 //是否开启;0:否;1:是;
}
</code></pre><h2 id="-">获取系统维护设置信息</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/get_is_upkeep</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: 1 //是否开启;0:否;1:是;
}
</code></pre><h1 id="-">设置</h1>
<h2 id="-author-sun-wu-">是否共享客户(仅主账号可操作;Author:Sun Wu)---废弃</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/is_share_customer</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;status&quot;: 1 //是否共享0:否;1:是;
    }
}
</code></pre><h2 id="-author-sun-wu-">是否将客户作为供应商使用(仅主账号可操作;Author:Sun Wu)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>列表</td>
<td>http</td>
<td>post</td>
<td>/is_set_as_supplier</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;status&quot;: 1 //是否将客户作为供应商使用0:否;1:是;
    }
}
</code></pre><h2 id="-author-sun-wu-">获取共享客户和供应商设置信息(仅主账号可操作;Author:Sun Wu)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/get_share_info</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>type</td>
<td>是</td>
<td>否</td>
<td>类型：0-供应商 1-客户</td>
<td>integer</td>
<td>0</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: 1 //状态;0:否;1:是;
}
</code></pre><h2 id="-vip-author-sun-wu-">设置的vip体验时间(仅超管可操作;Author:Sun Wu)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/set_experience_days</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>value</td>
<td>是</td>
<td>否</td>
<td>要设置的天数</td>
<td>integer</td>
<td>0</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-vip-author-sun-wu-">获取当前设置的vip体验时间(仅超管可操作;Author:Sun Wu)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/get_experience_days</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;15&quot; //天数
}
</code></pre><h2 id="-author-sun-wu-">是否共享快递信息;(Author:Sun Wu) 废弃</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/share_express_info</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: 0 //是否共享快递信息;0:否;1:是;
}
</code></pre><h1 id="vip-author-sun-wu-">VIP内容配置(Author：Sun Wu)</h1>
<h2 id="-">新建(废弃)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>新建</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/vip_setting_add</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>is_vip</td>
<td>是</td>
<td>否</td>
<td>是否有特权;0:否;1:是;</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>first_charge_price</td>
<td>是</td>
<td>否</td>
<td>首充金额</td>
<td>numeric</td>
<td>1.11</td>
</tr>
<tr>
<td>open_vip_cost</td>
<td>是</td>
<td>否</td>
<td>开通vip所需金额(默认为0)</td>
<td>numeric</td>
<td>1.11</td>
</tr>
<tr>
<td>album_amount</td>
<td>是</td>
<td>否</td>
<td>彩页数量(默认为0)</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>album_page_amount</td>
<td>是</td>
<td>否</td>
<td>彩页页数(默认为0)</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>empty_bill_amount</td>
<td>是</td>
<td>否</td>
<td>空白单数(默认为0)</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>special_seal</td>
<td>是</td>
<td>否</td>
<td>专用印章数(默认为0)</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>one_key_album_times</td>
<td>是</td>
<td>否</td>
<td>一键生成画册次数(默认为0)</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>express_check_times</td>
<td>是</td>
<td>否</td>
<td>快递查询次数(默认为0)</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>account_storage</td>
<td>是</td>
<td>否</td>
<td>存储空间(默认为0)</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>clear_watermark_or_not</td>
<td>是</td>
<td>否</td>
<td>去除水印;0:否;1:是;</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: 1   //新增id
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-08-24 10:42`:增加请求参数`first_charge_price`
`2022-08-16 17:15`:增加请求参数`open_vip_cost`
`2022-08-06 09:44`:增加请求参数`is_vip`
</code></pre><h2 id="-">列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>新建</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/vip_setting_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 1,
        &quot;is_vip&quot;: 0,//是否有特权;0:否;1:是;
        &quot;album_amount&quot;: 0,  //彩页数量
        &quot;open_vip_cost&quot;: 0,  //开通vip所需金额
        &quot;first_charge_price&quot;: 0,//首充金额
        &quot;album_page_amount&quot;: 0, //彩页页数
        &quot;empty_bill_amount&quot;: 0, //空白单数
        &quot;special_seal&quot;: 0,  //专用印章数
        &quot;one_key_album_times&quot;: 0,   //一键生成画册次数
        &quot;express_check_times&quot;: 0,   //快递查询次数
        &quot;account_storage&quot;: 0,   //存储空间
        &quot;clear_watermark_or_not&quot;: 0,    //去除水印
        &quot;created_at&quot;: 2022-08-04 17:32:21,
        &quot;updated_at&quot;: null
    }
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-08-24 10:42`:增加`first_charge_price`返回
`2022-08-16 17:15`:增加`open_vip_cost`返回
`2022-08-06 09:44`:增加`is_vip`返回
</code></pre><h2 id="-">编辑</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>新建</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/vip_setting_edit</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>vip内容标识</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>first_charge_price</td>
<td>是</td>
<td>否</td>
<td>首充金额</td>
<td>numeric</td>
<td>1.11</td>
</tr>
<tr>
<td>open_vip_cost</td>
<td>是</td>
<td>否</td>
<td>开通vip所需金额(默认为0)</td>
<td>numeric</td>
<td>1.11</td>
</tr>
<tr>
<td>is_vip</td>
<td>是</td>
<td>否</td>
<td>是否有特权;0:否;1:是;<code>不可编辑</code></td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>album_amount</td>
<td>是</td>
<td>否</td>
<td>彩页数量(默认为0)</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>album_page_amount</td>
<td>是</td>
<td>否</td>
<td>彩页页数(默认为0)</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>empty_bill_amount</td>
<td>是</td>
<td>否</td>
<td>空白单数(默认为0)</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>special_seal</td>
<td>是</td>
<td>否</td>
<td>专用印章数(默认为0)</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>one_key_album_times</td>
<td>是</td>
<td>否</td>
<td>一键生成画册次数(默认为0)</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>express_check_times</td>
<td>是</td>
<td>否</td>
<td>快递查询次数(默认为0)</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>account_storage</td>
<td>是</td>
<td>否</td>
<td>存储空间(默认为0)</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>clear_watermark_or_not</td>
<td>是</td>
<td>否</td>
<td>去除水印;0:否;1:是;</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &#39;&#39;
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-08-24 10:42`:增加请求参数`first_charge_price`
`2022-08-16 17:15`:增加请求参数`open_vip_cost`
`2022-08-06 09:44`:增加请求参数`is_vip`，编辑时该参数应被禁止修改
</code></pre><h2 id="-">详细</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>新建</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/vip_setting_detail</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 1,       //vip内容标识
        &quot;is_vip&quot;: 0,       //是否有特权;0:否;1:是;
        &quot;open_vip_cost&quot;: 0,  //开通vip所需金额
        &quot;album_amount&quot;: 1,     //彩页数量
        &quot;album_page_amount&quot;: 0,    //彩页页数
        &quot;empty_bill_amount&quot;: 0,    //空白单数
        &quot;special_seal&quot;: 0,     //专用印章数
        &quot;one_key_album_times&quot;: 0,      //一键生成画册次数
        &quot;express_check_times&quot;: 0,      //快递查询次数
        &quot;account_storage&quot;: 0,      //存储空间
        &quot;clear_watermark_or_not&quot;: 0,       //去除水印
    }
}
</code></pre><h1 id="-">商品管理</h1>
<h2 id="-">物料类型列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>物料类型列表</td>
<td>http</td>
<td>post</td>
<td>api/materiel_type_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>页面大小</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>当前页</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>materiel_class_id</td>
<td>否</td>
<td>是</td>
<td>物料所属二级分类id</td>
<td>integer</td>
<td>107</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>是</td>
<td>关键词(支持<code>物料名</code>,<code>物料型号</code>,<code>物料编号</code>)</td>
<td>string</td>
<td>电子体温计</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,//当前页
        &quot;data&quot;: [
            {
                &quot;id&quot;: 5590,//物料id
                &quot;materiel_name&quot;: &quot;小扑电池里用的&quot;,//物料名
                &quot;type_name&quot;: &quot;电池&quot;,//物料型号
                &quot;materiel_class_id&quot;: 107,//物料所属二级分类id
                &quot;length&quot;: &quot;0.00&quot;, //长度
                &quot;width&quot;: &quot;0.00&quot;,//宽度
                &quot;height&quot;: &quot;0.00&quot;,//高度
                &quot;weight&quot;: &quot;0.00&quot;,//重量
                &quot;attribute&quot;: &quot;&quot;,//属性
                &quot;cost&quot;: &quot;0.00&quot;,//成本
                &quot;main_id&quot;: 7,
                &quot;remark&quot;: null,
                &quot;delete_flag&quot;: 0,
                &quot;created_at&quot;: null,
                &quot;updated_at&quot;: null,
                &quot;materiel_img&quot;: null,//物料图
                &quot;materiel_no&quot;: &quot;&quot;,//物料编号
                &quot;s_class_id&quot;: 122,//二级分类id
                &quot;s_class_name&quot;: &quot;辅助工具&quot;,//二级分类名称
                &quot;s_class_no&quot;: &quot;&quot;,//二级分类编号
                &quot;f_class_name&quot;: &quot;工作箱&quot;,//一级分类名称
                &quot;f_class_no&quot;: &quot;&quot;,//一级分类编号
                &quot;f_class_id&quot;: 67//二级分类编号
                &quot;in_storage_num&quot;: 67,//物料在库数量,无数量时显示为`null`
                &quot;storage_id&quot;: 3,//仓库id
                &quot;storage_name&quot;: &quot;蚌埠掌上网络科技有限公司&quot;//仓库名称
                &quot;shelf_id&quot;: 1613, //货架ID
                &quot;location_id&quot;: 1614,//库位ID
                &quot;shelf_name&quot;: &quot;测试货架1&quot;, //货架名称
                &quot;location_name&quot;: &quot;测试库位2&quot; //库位名称
                &quot;is_use_serial&quot;:0,//是否开启序列号;0:否;1:是;
            }
        ],
        &quot;total&quot;: &quot;10&quot;,//总条数
    }
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-09-07 15:55`:增加请求参数`is_use_serial`
`2022-08-25 16:40`:增加`shelf_id`,`location_id`,`shelf_name`,`location_name`返回 
</code></pre></blockquote>
<h2 id="-">物料类型下拉列表(孙武)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>物料类型下拉列表</td>
<td>http</td>
<td>post</td>
<td>api/materiel_type_select</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>每页条数</td>
<td>integer</td>
<td>15</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>当前页码</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>materiel_calss_id</td>
<td>否</td>
<td>否</td>
<td>二级分类id，默认为0</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>否</td>
<td>关键词</td>
<td>string</td>
<td>面膜</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,//当前页
        &quot;data&quot;: [
            {
                &quot;id&quot;: 558,  //物料商品id
                &quot;materiel_name&quot;: &quot;艾纯烟酰胺亮肤补水修护套盒&quot;,   //物料名
                &quot;type_name&quot;: &quot;10件套&quot;,    //型号
                &quot;materiel_img&quot;: null,   //物料商品图
                &quot;materiel_no&quot;: &quot;&quot;,  //物料编号
                &quot;materiel_class_id&quot;: 9, //物料商品二级分类id
                &quot;sec_class_name&quot;: &quot;护肤品套装&quot;,  //物料商品二级分类名
                &quot;fir_class_id&quot;: 3,  //物料商品一级分类id
                &quot;fir_class_name&quot;: &quot;美妆用品&quot;,    //物料商品一级分类名
                &quot;remark&quot;: &quot;美妆用品&quot;    //商品备注
                &quot;length&quot;: &quot;0.00&quot;, //长度
                &quot;width&quot;: &quot;0.00&quot;,//宽度
                &quot;height&quot;: &quot;0.00&quot;,//高度
                &quot;weight&quot;: &quot;0.00&quot;,//重量
                &quot;attribute&quot;: &quot;&quot;,//属性
                &quot;cost&quot;: &quot;0.00&quot;,//成本
                &quot;selling_price&quot;:0.22,//售价
                &quot;is_use_serial&quot;:0,//是否开启序列号;0:否;1:是;
            }
        ],
        ......
        &quot;total&quot;: 1//总数
    }
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-09-07 16:06`:增加请求参数`selling_price`、`is_use_serial`
</code></pre></blockquote>
<h2 id="-">删除物料(孙武)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>删除物料(可批量删除)</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/materiel_type_del</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>物料类型id(多商品时，以逗号拼接)</td>
<td>string</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre></blockquote>
<h2 id="-">添加物料(孙武)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>编辑查询</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/materiel_type_add</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>materiel_name</td>
<td>是</td>
<td>否</td>
<td>物料名称</td>
<td>sting</td>
<td>保温箱</td>
</tr>
<tr>
<td>type_name</td>
<td>否</td>
<td>否</td>
<td>物料型号名称</td>
<td>sting</td>
<td>6L</td>
</tr>
<tr>
<td>materiel_img</td>
<td>否</td>
<td>是</td>
<td>物料类型图</td>
<td>sting</td>
<td><code>xxx.jpg</code> OR <code>xxx.png</code></td>
</tr>
<tr>
<td>materiel_no</td>
<td>否</td>
<td>是</td>
<td>物料编号</td>
<td>string</td>
<td>7udIZcaQ</td>
</tr>
<tr>
<td>materiel_class_id</td>
<td>是</td>
<td>否</td>
<td>物料二级分类id</td>
<td>integer</td>
<td>179</td>
</tr>
<tr>
<td>length</td>
<td>是</td>
<td>是</td>
<td>长(cm</td>
<td>numeric</td>
<td>19.1</td>
</tr>
<tr>
<td>width</td>
<td>否</td>
<td>是</td>
<td>宽(cm)</td>
<td>numeric</td>
<td>0.1</td>
</tr>
<tr>
<td>height</td>
<td>否</td>
<td>是</td>
<td>高(cm)</td>
<td>numeric</td>
<td>1.3</td>
</tr>
<tr>
<td>weight</td>
<td>否</td>
<td>是</td>
<td>重量(kg)</td>
<td>numeric</td>
<td>3000</td>
</tr>
<tr>
<td>attribute</td>
<td>否</td>
<td>是</td>
<td>属性</td>
<td>string</td>
<td>随便</td>
</tr>
<tr>
<td>cost</td>
<td>是</td>
<td>否</td>
<td>成本</td>
<td>numeric</td>
<td>0.01</td>
</tr>
<tr>
<td>selling_price</td>
<td>否</td>
<td>是</td>
<td>销售价</td>
<td>numeric</td>
<td>10000</td>
</tr>
<tr>
<td>lower_selling_price</td>
<td>否</td>
<td>是</td>
<td>最低销售价格</td>
<td>numeric</td>
<td>10000</td>
</tr>
<tr>
<td>materiel_unit</td>
<td>否</td>
<td>是</td>
<td>商品单位</td>
<td>string</td>
<td>件</td>
</tr>
<tr>
<td>is_album</td>
<td>是</td>
<td>否</td>
<td>是否在画册中展示(默认为0);0:否;1:是;</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>是</td>
<td>备注</td>
<td>string</td>
<td>这是备注</td>
</tr>
<tr>
<td>is_use_serial</td>
<td>是</td>
<td>否</td>
<td>是否开启序列号;0:否;1:是;</td>
<td>0</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 5032 //新增物料id
    }
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-09-07 15:43`:增加请求参数`is_use_serial`
`2022-08-05 20:13`:增加请求参数`lower_selling_price`,`is_album`,`materiel_unit`
</code></pre><h2 id="-">修改物料商品(孙武)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>修改物料商品</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/materiel_type_edit</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>物料商品id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>materiel_name</td>
<td>是</td>
<td>否</td>
<td>物料名称</td>
<td>sting</td>
<td>保温箱</td>
</tr>
<tr>
<td>type_name</td>
<td>否</td>
<td>否</td>
<td>物料型号名称</td>
<td>sting</td>
<td>6L</td>
</tr>
<tr>
<td>materiel_img</td>
<td>否</td>
<td>是</td>
<td>物料类型图</td>
<td>sting</td>
<td><code>xxx.jpg</code> OR <code>xxx.png</code></td>
</tr>
<tr>
<td>materiel_no</td>
<td>否</td>
<td>是</td>
<td>物料编号</td>
<td>string</td>
<td>7udIZcaQ</td>
</tr>
<tr>
<td>materiel_class_id</td>
<td>是</td>
<td>否</td>
<td>物料二级分类id</td>
<td>integer</td>
<td>179</td>
</tr>
<tr>
<td>length</td>
<td>是</td>
<td>是</td>
<td>长(cm</td>
<td>numeric</td>
<td>19.1</td>
</tr>
<tr>
<td>width</td>
<td>否</td>
<td>是</td>
<td>宽(cm)</td>
<td>numeric</td>
<td>0.1</td>
</tr>
<tr>
<td>height</td>
<td>否</td>
<td>是</td>
<td>高(cm)</td>
<td>numeric</td>
<td>1.3</td>
</tr>
<tr>
<td>weight</td>
<td>否</td>
<td>是</td>
<td>重量(kg)</td>
<td>numeric</td>
<td>3000</td>
</tr>
<tr>
<td>attribute</td>
<td>否</td>
<td>是</td>
<td>属性</td>
<td>string</td>
<td>随便</td>
</tr>
<tr>
<td>cost</td>
<td>是</td>
<td>否</td>
<td>成本</td>
<td>numeric</td>
<td>0.01</td>
</tr>
<tr>
<td>selling_price</td>
<td>否</td>
<td>是</td>
<td>销售价</td>
<td>numeric</td>
<td>10000</td>
</tr>
<tr>
<td>lower_selling_price</td>
<td>否</td>
<td>是</td>
<td>最低销售价格</td>
<td>numeric</td>
<td>10000</td>
</tr>
<tr>
<td>materiel_unit</td>
<td>否</td>
<td>是</td>
<td>商品单位</td>
<td>string</td>
<td>件</td>
</tr>
<tr>
<td>is_album</td>
<td>是</td>
<td>否</td>
<td>是否在画册中展示(默认为0);0:否;1:是;</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>是</td>
<td>备注</td>
<td>string</td>
<td>这是备注</td>
</tr>
<tr>
<td>is_use_serial</td>
<td>是</td>
<td>否</td>
<td>是否开启序列号;0:否;1:是;</td>
<td>0</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-09-07 15:43`:增加请求参数`is_use_serial`
`2022-08-05 20:13`:增加请求参数`lower_selling_price`,`is_album`,`materiel_unit`(与接口`materiel_type_edit`增加的请求参数相同)
</code></pre><h2 id="-">指定物料类型详细信息(孙武)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>编辑查询</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/materiel_type_info</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>物料类型id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 1,//物料类型id
        &quot;materiel_name&quot;: &quot;400ML注水冰盒&quot;,//物料类型名称
        &quot;type_name&quot;: &quot;400ML&quot;,//物料型号
        &quot;materiel_img&quot;: null,//物料图
        &quot;materiel_no&quot;: &quot;&quot;,//物料编号
        &quot;materiel_class_id&quot;: 71,//物料分类二级id
        &quot;remark&quot;: null,//物料备注
        &quot;length&quot;: &quot;0.00&quot;, //长度
        &quot;width&quot;: &quot;0.00&quot;,//宽度
        &quot;height&quot;: &quot;0.00&quot;,//高度
        &quot;weight&quot;: &quot;0.00&quot;,//重量
        &quot;attribute&quot;: &quot;&quot;,//属性
        &quot;cost&quot;: &quot;0.00&quot;,//成本
        &quot;sec_class_name&quot;: &quot;冷源&quot;,//物料二级分类名称
        &quot;fir_class_id&quot;: 56,//物料一级分类id
        &quot;fir_class_name&quot;: &quot;保温箱类&quot;//物料一级分类名称
        &quot;selling_price&quot;:0//销售价格
        &quot;lower_selling_price&quot;:0//最低销售价格
        &quot;is_album&quot;:0,//是否在画册中展示;0:否;1:是;
        &quot;materiel_unit&quot;: &quot;件&quot;,//单位
        &quot;is_use_serial&quot;: 0,//是否开启序列号;0:否;1:是;
    }
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-09-07 15:55`:增加请求参数`is_use_serial`
`2022-08-05 20:13`:增加请求参数`lower_selling_price`,`is_album`,`materiel_unit`,`selling_price`(与接口`materiel_type_edit`增加的请求参数相同)
</code></pre><h1 id="-sun-wu-">库存列表(Sun Wu)</h1>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>编辑查询</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/storage_manage_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>每页显示条数</td>
<td>string</td>
<td>1895555555</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>页码</td>
<td>string</td>
<td>1</td>
</tr>
<tr>
<td>storage_id</td>
<td>否</td>
<td>否</td>
<td>仓库id</td>
<td>integer</td>
<td>123456</td>
</tr>
<tr>
<td>materiel_class_id</td>
<td>否</td>
<td>是</td>
<td>物料所属二级分类id</td>
<td>integer</td>
<td>107</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>是</td>
<td>关键词(支持<code>物料名</code>,<code>物料型号</code>,<code>物料编号</code>)</td>
<td>string</td>
<td>电子体温计</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,//当前页
        &quot;data&quot;: [
            {
                &quot;id&quot;: 537,//库存id
                &quot;type_id&quot;: 557,//物料id
                &quot;materiel_name&quot;: &quot;丽肤宝透明质酸补水保湿套盒&quot;,//物料名称
                &quot;type_name&quot;: &quot;5件套&quot;,//物料型号
                &quot;materiel_no&quot;: &quot;&quot;,//物料编号
                &quot;materiel_img&quot;: &#39;&#39;,//物料商品图
                &quot;materiel_mean_cost&quot;: &quot;0.00&quot;,//物料成本价
                &quot;storage_id&quot;: 48,//仓库id
                &quot;storage_name&quot;: &quot;B1-9栋&quot;,//所在仓库
                &quot;storage_address&quot;: &quot;B1-9栋&quot;,//所在仓库地址
                &quot;in_storage_num&quot;: 128,//库存数
                &quot;alert_num&quot;: 0,//低库存预警数
                &quot;f_class_id&quot;: 3,//一级分类id
                &quot;f_class_name&quot;: &quot;美妆用品&quot;,//一级分类名称
                &quot;f_class_no&quot;: &quot;&quot;//一级分类编号
                &quot;s_class_id&quot;: 9,//二级分类id
                &quot;s_class_name&quot;: &quot;护肤品套装&quot;,//二级分类名称
                &quot;s_class_no&quot;: &quot;&quot;,//二级分类编号
                &quot;remark&quot;: &quot;&quot;//商品备注
                &quot;shelf_id&quot;: 0,  //货架id
                &quot;location_id&quot;: 0,   //库位id
                &quot;shelf_name&quot;: null, //货架名
                &quot;location_name&quot;: null,  //库位名
                &quot;is_use_serial&quot;: 0  //是否开启序列号;0:否;1:是;
            },
            ......
        ],
        &quot;total&quot;: &quot;10&quot;,//页面大小
    }
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-09-07 18:36`:新增返回参数`shelf_id`、`location_id`、`shelf_name`、`location_name`、`is_use_serial`
</code></pre><h1 id="-zlf-">空白单据（zlf）</h1>
<h2 id="-">生成编号（前端自己生成或用此接口生成）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>生成编号</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/get_create_number</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td></td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;number&quot;: &quot;F46371659433919483&quot;//编号
    }
}
</code></pre><h2 id="-">选择物料商品（所有选择商品操作）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>选择商品列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/get_select_goods</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>page_size</td>
<td>是</td>
<td>否</td>
<td>显示页数</td>
<td>integer</td>
<td>15</td>
</tr>
<tr>
<td>current_page</td>
<td>是</td>
<td>否</td>
<td>当前页码</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,//当前页
        &quot;data&quot;: [
            {
                &quot;id&quot;: 558,  //物料商品id
                &quot;materiel_name&quot;: &quot;艾纯烟酰胺亮肤补水修护套盒&quot;,   //物料名
                &quot;type_name&quot;: &quot;10件套&quot;,    //型号
                &quot;materiel_img&quot;: null,   //物料商品图
                &quot;materiel_no&quot;: &quot;&quot;,  //物料编号
                &quot;materiel_class_id&quot;: 9, //物料商品二级分类id
                &quot;sec_class_name&quot;: &quot;护肤品套装&quot;,  //物料商品二级分类名
                &quot;fir_class_id&quot;: 3,  //物料商品一级分类id
                &quot;fir_class_name&quot;: &quot;美妆用品&quot;,    //物料商品一级分类名
                &quot;remark&quot;: &quot;美妆用品&quot;    //商品备注
                &quot;length&quot;: &quot;0.00&quot;, //长度
                &quot;width&quot;: &quot;0.00&quot;,//宽度
                &quot;height&quot;: &quot;0.00&quot;,//高度
                &quot;weight&quot;: &quot;0.00&quot;,//重量
                &quot;attribute&quot;: &quot;&quot;,//属性
                &quot;cost&quot;: &quot;0.00&quot;,//成本
            }
        ],
        ......
        &quot;total&quot;: 1//总数
    }
}
</code></pre><h2 id="-">发货单信息新建</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>发货单信息添加</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/add_dispatch_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>order_no</td>
<td>否</td>
<td>否</td>
<td>发货单号（为空时，后台生成）</td>
<td>string</td>
<td>243235423523</td>
</tr>
<tr>
<td>consignee</td>
<td>否</td>
<td>否</td>
<td>收货人</td>
<td>string</td>
<td>王五</td>
</tr>
<tr>
<td>phone</td>
<td>否</td>
<td>否</td>
<td>收货人联系电话</td>
<td>string</td>
<td>17681138888</td>
</tr>
<tr>
<td>address</td>
<td>否</td>
<td>否</td>
<td>收货地址</td>
<td>string</td>
<td>安徽蚌埠</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>非常好</td>
</tr>
<tr>
<td>total_number</td>
<td>否</td>
<td>否</td>
<td>本单总件数</td>
<td>string</td>
<td>1000</td>
</tr>
<tr>
<td>total_cost</td>
<td>否</td>
<td>否</td>
<td>总费用</td>
<td>string</td>
<td>100000</td>
</tr>
<tr>
<td>total_cost_dx</td>
<td>否</td>
<td>否</td>
<td>总费用大写</td>
<td>string</td>
<td>十万</td>
</tr>
<tr>
<td>deliver_person</td>
<td>否</td>
<td>否</td>
<td>发货人</td>
<td>string</td>
<td>李四</td>
</tr>
<tr>
<td>customer_signature</td>
<td>否</td>
<td>否</td>
<td>客户签字（文字或图片）</td>
<td>string/file</td>
<td>王二嘛</td>
</tr>
<tr>
<td>deliver_time</td>
<td>否</td>
<td>否</td>
<td>发货时间</td>
<td>string</td>
<td>2022-07-28 09:29:00</td>
</tr>
<tr>
<td>order_time</td>
<td>否</td>
<td>否</td>
<td>下单时间</td>
<td>string</td>
<td>2022-07-28 09:29:00</td>
</tr>
<tr>
<td>goods_info</td>
<td>否</td>
<td>否</td>
<td>商品信息包</td>
<td>array</td>
<td>[{&quot;name&quot;:&quot;葡萄&quot;,&quot;type_name&quot;:&quot;紫&quot;,&quot;product_unit&quot;:&quot;件&quot;,&quot;price&quot;:&quot;5.6&quot;,&quot;num&quot;:&quot;10&quot;,&quot;number_parcels&quot;:&quot;5&quot;,&quot;serial_number&quot;:11},{&quot;name&quot;:&quot;水梨&quot;,&quot;type_name&quot;:&quot;黄&quot;,&quot;product_unit&quot;:&quot;件&quot;,&quot;price&quot;:&quot;3.6&quot;,&quot;num&quot;:&quot;8&quot;,&quot;number_parcels&quot;:&quot;4&quot;,&quot;serial_number&quot;:22}]</td>
</tr>
<tr>
<td>name</td>
<td>否</td>
<td>否</td>
<td>商品名称（商品信息包里包括）</td>
<td>string</td>
<td>葡萄</td>
</tr>
<tr>
<td>type_name</td>
<td>否</td>
<td>否</td>
<td>商品规格（商品信息包里包括）</td>
<td>string</td>
<td>G000088888</td>
</tr>
<tr>
<td>product_unit</td>
<td>否</td>
<td>否</td>
<td>商品单位（商品信息包里包括）</td>
<td>string</td>
<td>件</td>
</tr>
<tr>
<td>price</td>
<td>否</td>
<td>否</td>
<td>单价 （商品信息包里包括）</td>
<td>string</td>
<td>9.6</td>
</tr>
<tr>
<td>num</td>
<td>否</td>
<td>否</td>
<td>商品数量 （商品信息包里包括）</td>
<td>string</td>
<td>10</td>
</tr>
<tr>
<td>number_parcels</td>
<td>否</td>
<td>否</td>
<td>包裹件数（商品信息包里包括）</td>
<td>string</td>
<td>10</td>
</tr>
<tr>
<td>serial_number</td>
<td>否</td>
<td>否</td>
<td>序号（商品信息包里包括）</td>
<td>string</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">发货单信息修改</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>发货单信息修改</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/upd_dispatch_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>dispatch_id</td>
<td>是</td>
<td>否</td>
<td>发货单id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>consignee</td>
<td>否</td>
<td>否</td>
<td>收货人</td>
<td>string</td>
<td>王五</td>
</tr>
<tr>
<td>phone</td>
<td>否</td>
<td>否</td>
<td>收货人联系电话</td>
<td>string</td>
<td>17681138888di</td>
</tr>
<tr>
<td>address</td>
<td>否</td>
<td>否</td>
<td>收货地址</td>
<td>string</td>
<td>安徽蚌埠</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>非常好</td>
</tr>
<tr>
<td>total_number</td>
<td>否</td>
<td>否</td>
<td>本单总件数</td>
<td>string</td>
<td>1000</td>
</tr>
<tr>
<td>total_cost</td>
<td>否</td>
<td>否</td>
<td>总费用</td>
<td>string</td>
<td>100000</td>
</tr>
<tr>
<td>total_cost_dx</td>
<td>否</td>
<td>否</td>
<td>总费用大写</td>
<td>string</td>
<td>十万</td>
</tr>
<tr>
<td>deliver_person</td>
<td>否</td>
<td>否</td>
<td>发货人</td>
<td>string</td>
<td>李四</td>
</tr>
<tr>
<td>customer_signature</td>
<td>否</td>
<td>否</td>
<td>客户签字（文字或图片）</td>
<td>string/file</td>
<td>王二嘛</td>
</tr>
<tr>
<td>deliver_time</td>
<td>否</td>
<td>否</td>
<td>发货时间</td>
<td>string</td>
<td>2022-07-28 09:29:00</td>
</tr>
<tr>
<td>order_time</td>
<td>否</td>
<td>否</td>
<td>下单时间</td>
<td>string</td>
<td>2022-07-28 09:29:00</td>
</tr>
<tr>
<td>goods_info</td>
<td>否</td>
<td>否</td>
<td>商品信息包(修改时，可以新增商品)</td>
<td>array</td>
<td>[{&quot;goods_id&quot;:1,&quot;name&quot;:&quot;葡萄11&quot;,&quot;type_name&quot;:&quot;紫11&quot;,&quot;product_unit&quot;:&quot;件&quot;,&quot;price&quot;:&quot;5.611&quot;,&quot;num&quot;:&quot;1011&quot;,&quot;number_parcels&quot;:&quot;5&quot;,&quot;serial_number&quot;:11},{&quot;goods_id&quot;:2,&quot;name&quot;:&quot;水梨2222&quot;,&quot;type_name&quot;:&quot;黄22&quot;,&quot;product_unit&quot;:&quot;件&quot;,&quot;price&quot;:&quot;3.6&quot;,&quot;num&quot;:&quot;8&quot;,&quot;number_parcels&quot;:&quot;4&quot;,&quot;serial_number&quot;:22},{&quot;name&quot;:&quot;水梨8888&quot;,&quot;type_name&quot;:&quot;黄888&quot;,&quot;product_unit&quot;:&quot;件&quot;,&quot;price&quot;:&quot;3.6&quot;,&quot;num&quot;:&quot;8&quot;,&quot;number_parcels&quot;:&quot;4&quot;,&quot;serial_number&quot;:22}]</td>
</tr>
<tr>
<td>goods_id</td>
<td>是</td>
<td>否</td>
<td>商品id （商品信息包里包括）</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>name</td>
<td>否</td>
<td>否</td>
<td>商品名称（商品信息包里包括）</td>
<td>string</td>
<td>葡萄</td>
</tr>
<tr>
<td>type_name</td>
<td>否</td>
<td>否</td>
<td>商品规格（商品信息包里包括）</td>
<td>string</td>
<td>G000088888</td>
</tr>
<tr>
<td>product_unit</td>
<td>否</td>
<td>否</td>
<td>商品单位（商品信息包里包括）</td>
<td>string</td>
<td>件</td>
</tr>
<tr>
<td>price</td>
<td>否</td>
<td>否</td>
<td>单价 （商品信息包里包括）</td>
<td>string</td>
<td>9.6</td>
</tr>
<tr>
<td>num</td>
<td>否</td>
<td>否</td>
<td>商品数量 （商品信息包里包括）</td>
<td>string</td>
<td>10</td>
</tr>
<tr>
<td>number_parcels</td>
<td>否</td>
<td>否</td>
<td>包裹件数（商品信息包里包括）</td>
<td>string</td>
<td>10</td>
</tr>
<tr>
<td>serial_number</td>
<td>否</td>
<td>否</td>
<td>序号（商品信息包里包括）</td>
<td>string</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">发货单信息删除（批量删除）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>发货单信息删除</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/del_dispatch_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>ids</td>
<td>是</td>
<td>否</td>
<td>发货单id (多个逗号分隔)</td>
<td>integer</td>
<td>1,2,3</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">删除发货单商品（批量删除）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>删除发货单商品</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/del_dispatch_goods</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>goods_ids</td>
<td>是</td>
<td>否</td>
<td>商品id (多个逗号分隔)</td>
<td>integer</td>
<td>1,2,3</td>
</tr>
<tr>
<td>dispatch_id</td>
<td>是</td>
<td>否</td>
<td>发货单id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">发货单信息查询</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>发货单信息查询</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/dispatch_list_info</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>dispatch_id</td>
<td>是</td>
<td>否</td>
<td>发货单id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 1,//发货单id
        &quot;main_id&quot;: 4637, //主账号id
        &quot;user_id&quot;: 4637, //操作人id
        &quot;order_no&quot;: &quot;F46371658972770016&quot;,//发货单号
        &quot;consignee&quot;: &quot;王九9999&quot;,//收货人
        &quot;phone&quot;: &quot;17681130888&quot;,//收货人联系电话
        &quot;address&quot;: &quot;安徽合肥999&quot;,//收货地址
        &quot;remark&quot;: &quot;好的很999&quot;,//备注
        &quot;total_number&quot;: 5,//本单总件数
        &quot;total_cost&quot;: &quot;100000.000000&quot;,//总费用
        &quot;total_cost_dx&quot;: &quot;十万&quot;,//总费用大写
        &quot;deliver_person&quot;: &quot;张三&quot;,//发货人
        &quot;customer_signature&quot;: &quot;李四&quot;,//客户签字
        &quot;deliver_time&quot;: &quot;1658971740&quot;,//发货时间 
        &quot;order_time&quot;: &quot;2022&quot;,//下单时间 
        &quot;created_at&quot;: &quot;2022-07-28 13:43:27&quot;,//创建时间
        &quot;updated_at&quot;: &quot;1970-01-01 08:33:42&quot;,//更新时间
        &quot;goods_list&quot;: [
            {
                &quot;id&quot;: 1,
                &quot;dispatch_id&quot;: 1,//发货单id
                &quot;main_id&quot;: 4637,
                &quot;user_id&quot;: 4637,
                &quot;name&quot;: &quot;葡萄11&quot;,//商品名称
                &quot;type_name&quot;: &quot;紫11&quot;,//商品规格
                &quot;product_unit&quot;: &quot;件&quot;,//商品单位
                &quot;price&quot;: &quot;5.611000&quot;,//单价
                &quot;num&quot;: 1011,    //商品数量
                &quot;number_parcels&quot;: 5,//包裹件数
                &quot;serial_number&quot;: 11,//序号
                &quot;created_at&quot;: null,//创建时间
                &quot;updated_at&quot;: &quot;2022-07-28 13:57:09&quot;//更新时间
            },
            ......
        ]
    }
}
</code></pre><h2 id="-">发货单信息列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>发货单信息列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/get_dispatch_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>page_size</td>
<td>是</td>
<td>否</td>
<td>分页个数</td>
<td>integer</td>
<td>15</td>
</tr>
<tr>
<td>current_page</td>
<td>是</td>
<td>否</td>
<td>当前页码</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>否</td>
<td>关键词查询</td>
<td>string</td>
<td>掌上网络</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
            {
                 &quot;id&quot;: 1,//发货单id
                &quot;main_id&quot;: 4637, //主账号id
                &quot;user_id&quot;: 4637, //操作人id
                &quot;order_no&quot;: &quot;F46371658972770016&quot;,//发货单号
                &quot;consignee&quot;: &quot;王九9999&quot;,//收货人
                &quot;phone&quot;: &quot;17681130888&quot;,//收货人联系电话
                &quot;address&quot;: &quot;安徽合肥999&quot;,//收货地址
                &quot;remark&quot;: &quot;好的很999&quot;,//备注
                &quot;total_number&quot;: 5,//本单总件数
                &quot;total_cost&quot;: &quot;100000.000000&quot;,//总费用
                &quot;total_cost_dx&quot;: &quot;十万&quot;,//总费用大写
                &quot;deliver_person&quot;: &quot;张三&quot;,//发货人
                &quot;customer_signature&quot;: &quot;李四&quot;,//客户签字
                &quot;deliver_time&quot;: &quot;1658971740&quot;,//发货时间 
                &quot;order_time&quot;: &quot;2022&quot;,//下单时间 
                &quot;created_at&quot;: &quot;2022-07-28 13:43:27&quot;,//创建时间
                &quot;updated_at&quot;: &quot;1970-01-01 08:33:42&quot;,//更新时间
                &quot;goods_info&quot;: [
                    {
                          &quot;id&quot;: 1,//商品id
                        &quot;dispatch_id&quot;: 1,//发货单id
                        &quot;main_id&quot;: 4637,
                        &quot;user_id&quot;: 4637,
                        &quot;name&quot;: &quot;葡萄11&quot;,//商品名称
                        &quot;type_name&quot;: &quot;紫11&quot;,//商品规格
                        &quot;product_unit&quot;: &quot;件&quot;,//商品单位
                        &quot;price&quot;: &quot;5.611000&quot;,//单价
                        &quot;num&quot;: 1011,    //商品数量
                        &quot;number_parcels&quot;: 5,//包裹件数
                        &quot;serial_number&quot;: 11,//序号
                        &quot;created_at&quot;: null,//创建时间
                        &quot;updated_at&quot;: &quot;2022-07-28 13:57:09&quot;//更新时间
                    },
                    ......
                ]
            },
           ......
        ],
       ....
        &quot;next_page_url&quot;: null,        
        &quot;total&quot;: 7
    }
}
</code></pre><h2 id="-token-">发货单信息查询（分享和打印、不用token）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>发货单信息查询</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/dispatch_info</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>dispatch_id</td>
<td>是</td>
<td>否</td>
<td>发货单id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 1,//发货单id
        &quot;main_id&quot;: 4637, //主账号id
        &quot;user_id&quot;: 4637, //操作人id
        &quot;order_no&quot;: &quot;F46371658972770016&quot;,//发货单号
        &quot;consignee&quot;: &quot;王九9999&quot;,//收货人
        &quot;phone&quot;: &quot;17681130888&quot;,//收货人联系电话
        &quot;address&quot;: &quot;安徽合肥999&quot;,//收货地址
        &quot;remark&quot;: &quot;好的很999&quot;,//备注
        &quot;total_number&quot;: 5,//本单总件数
        &quot;total_cost&quot;: &quot;100000.000000&quot;,//总费用
        &quot;total_cost_dx&quot;: &quot;十万&quot;,//总费用大写
        &quot;deliver_person&quot;: &quot;张三&quot;,//发货人
        &quot;customer_signature&quot;: &quot;李四&quot;,//客户签字
        &quot;deliver_time&quot;: &quot;1658971740&quot;,//发货时间 
        &quot;order_time&quot;: &quot;2022&quot;,//下单时间 
        &quot;created_at&quot;: &quot;2022-07-28 13:43:27&quot;,//创建时间
        &quot;updated_at&quot;: &quot;1970-01-01 08:33:42&quot;,//更新时间
        &quot;goods_list&quot;: [
            {
                &quot;id&quot;: 1,
                &quot;dispatch_id&quot;: 1,//发货单id
                &quot;main_id&quot;: 4637,
                &quot;user_id&quot;: 4637,
                &quot;name&quot;: &quot;葡萄11&quot;,//商品名称
                &quot;type_name&quot;: &quot;紫11&quot;,//商品规格
                &quot;product_unit&quot;: &quot;件&quot;,//商品单位
                &quot;price&quot;: &quot;5.611000&quot;,//单价
                &quot;num&quot;: 1011,    //商品数量
                &quot;number_parcels&quot;: 5,//包裹件数
                &quot;serial_number&quot;: 11,//序号
                &quot;created_at&quot;: null,//创建时间
                &quot;updated_at&quot;: &quot;2022-07-28 13:57:09&quot;//更新时间
            },
            ......
        ]
    }
}
</code></pre><h2 id="-">送货单信息新建</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>送货单信息添加</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/add_delivery_ship</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>delivery_no</td>
<td>否</td>
<td>否</td>
<td>送货单号（为空时，后台生成）</td>
<td>string</td>
<td>243235423523</td>
</tr>
<tr>
<td>consignee</td>
<td>否</td>
<td>否</td>
<td>提货人</td>
<td>string</td>
<td>王五</td>
</tr>
<tr>
<td>consignee_phone</td>
<td>否</td>
<td>否</td>
<td>提货人联系电话</td>
<td>string</td>
<td>17681138888</td>
</tr>
<tr>
<td>consignee_address</td>
<td>否</td>
<td>否</td>
<td>提货人地址</td>
<td>string</td>
<td>安徽蚌埠</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>非常好</td>
</tr>
<tr>
<td>order_time</td>
<td>否</td>
<td>否</td>
<td>下单时间</td>
<td>string</td>
<td>2022-07-28 09:29:00</td>
</tr>
<tr>
<td>total_cost</td>
<td>否</td>
<td>否</td>
<td>总费用</td>
<td>string</td>
<td>100000</td>
</tr>
<tr>
<td>total_cost_dx</td>
<td>否</td>
<td>否</td>
<td>总费用大写</td>
<td>string</td>
<td>十万</td>
</tr>
<tr>
<td>deliver_person</td>
<td>否</td>
<td>否</td>
<td>发货人</td>
<td>string</td>
<td>李四</td>
</tr>
<tr>
<td>customer_signature</td>
<td>否</td>
<td>否</td>
<td>提货人签字（文字或图片）</td>
<td>string/file</td>
<td>王二嘛</td>
</tr>
<tr>
<td>goods_info</td>
<td>否</td>
<td>否</td>
<td>商品信息包</td>
<td>array</td>
<td>[{&quot;name&quot;:&quot;葡萄&quot;,&quot;type_name&quot;:&quot;紫&quot;,&quot;product_unit&quot;:&quot;件&quot;,&quot;price&quot;:&quot;5.6&quot;,&quot;num&quot;:&quot;10&quot;,&quot;number_parcels&quot;:&quot;5&quot;,&quot;serial_number&quot;:11},{&quot;name&quot;:&quot;水梨&quot;,&quot;type_name&quot;:&quot;黄&quot;,&quot;product_unit&quot;:&quot;件&quot;,&quot;price&quot;:&quot;3.6&quot;,&quot;num&quot;:&quot;8&quot;,&quot;number_parcels&quot;:&quot;4&quot;,&quot;serial_number&quot;:22}]</td>
</tr>
<tr>
<td>name</td>
<td>否</td>
<td>否</td>
<td>商品名称（商品信息包里包括）</td>
<td>string</td>
<td>葡萄</td>
</tr>
<tr>
<td>type_name</td>
<td>否</td>
<td>否</td>
<td>商品规格（商品信息包里包括）</td>
<td>string</td>
<td>G000088888</td>
</tr>
<tr>
<td>product_unit</td>
<td>否</td>
<td>否</td>
<td>商品单位（商品信息包里包括）</td>
<td>string</td>
<td>件</td>
</tr>
<tr>
<td>price</td>
<td>否</td>
<td>否</td>
<td>单价 （商品信息包里包括）</td>
<td>string</td>
<td>9.6</td>
</tr>
<tr>
<td>num</td>
<td>否</td>
<td>否</td>
<td>商品数量 （商品信息包里包括）</td>
<td>string</td>
<td>10</td>
</tr>
<tr>
<td>number_parcels</td>
<td>否</td>
<td>否</td>
<td>包裹件数（商品信息包里包括）</td>
<td>string</td>
<td>10</td>
</tr>
<tr>
<td>serial_number</td>
<td>否</td>
<td>否</td>
<td>序号（商品信息包里包括）</td>
<td>string</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">送货单信息修改</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>送货单信息修改</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/upd_delivery_ship</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>delivery_id</td>
<td>是</td>
<td>否</td>
<td>送货单id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>consignee</td>
<td>否</td>
<td>否</td>
<td>提货人</td>
<td>string</td>
<td>王五</td>
</tr>
<tr>
<td>consignee_phone</td>
<td>否</td>
<td>否</td>
<td>提货人联系电话</td>
<td>string</td>
<td>17681138888</td>
</tr>
<tr>
<td>consignee_address</td>
<td>否</td>
<td>否</td>
<td>提货人地址</td>
<td>string</td>
<td>安徽蚌埠</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>非常好</td>
</tr>
<tr>
<td>order_time</td>
<td>否</td>
<td>否</td>
<td>下单时间</td>
<td>string</td>
<td>2022-07-28 09:29:00</td>
</tr>
<tr>
<td>total_cost</td>
<td>否</td>
<td>否</td>
<td>总费用</td>
<td>string</td>
<td>100000</td>
</tr>
<tr>
<td>total_cost_dx</td>
<td>否</td>
<td>否</td>
<td>总费用大写</td>
<td>string</td>
<td>十万</td>
</tr>
<tr>
<td>deliver_person</td>
<td>否</td>
<td>否</td>
<td>发货人</td>
<td>string</td>
<td>李四</td>
</tr>
<tr>
<td>customer_signature</td>
<td>否</td>
<td>否</td>
<td>提货人签字（文字或图片）</td>
<td>string/file</td>
<td>王二嘛</td>
</tr>
<tr>
<td>goods_info</td>
<td>否</td>
<td>否</td>
<td>商品信息包(修改时，可以新增商品)</td>
<td>array</td>
<td>[{&quot;goods_id&quot;:1,&quot;name&quot;:&quot;葡萄11&quot;,&quot;type_name&quot;:&quot;紫11&quot;,&quot;product_unit&quot;:&quot;件&quot;,&quot;price&quot;:&quot;5.611&quot;,&quot;num&quot;:&quot;1011&quot;,&quot;number_parcels&quot;:&quot;5&quot;,&quot;serial_number&quot;:11},{&quot;goods_id&quot;:2,&quot;name&quot;:&quot;水梨2222&quot;,&quot;type_name&quot;:&quot;黄22&quot;,&quot;product_unit&quot;:&quot;件&quot;,&quot;price&quot;:&quot;3.6&quot;,&quot;num&quot;:&quot;8&quot;,&quot;number_parcels&quot;:&quot;4&quot;,&quot;serial_number&quot;:22},{&quot;name&quot;:&quot;水梨8888&quot;,&quot;type_name&quot;:&quot;黄888&quot;,&quot;product_unit&quot;:&quot;件&quot;,&quot;price&quot;:&quot;3.6&quot;,&quot;num&quot;:&quot;8&quot;,&quot;number_parcels&quot;:&quot;4&quot;,&quot;serial_number&quot;:22}]</td>
</tr>
<tr>
<td>goods_id</td>
<td>是</td>
<td>否</td>
<td>商品id （商品信息包里包括）</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>name</td>
<td>否</td>
<td>否</td>
<td>商品名称（商品信息包里包括）</td>
<td>string</td>
<td>葡萄</td>
</tr>
<tr>
<td>type_name</td>
<td>否</td>
<td>否</td>
<td>商品规格（商品信息包里包括）</td>
<td>string</td>
<td>G000088888</td>
</tr>
<tr>
<td>product_unit</td>
<td>否</td>
<td>否</td>
<td>商品单位（商品信息包里包括）</td>
<td>string</td>
<td>件</td>
</tr>
<tr>
<td>price</td>
<td>否</td>
<td>否</td>
<td>单价 （商品信息包里包括）</td>
<td>string</td>
<td>9.6</td>
</tr>
<tr>
<td>num</td>
<td>否</td>
<td>否</td>
<td>商品数量 （商品信息包里包括）</td>
<td>string</td>
<td>10</td>
</tr>
<tr>
<td>number_parcels</td>
<td>否</td>
<td>否</td>
<td>包裹件数（商品信息包里包括）</td>
<td>string</td>
<td>10</td>
</tr>
<tr>
<td>serial_number</td>
<td>否</td>
<td>否</td>
<td>序号（商品信息包里包括）</td>
<td>string</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">送货单信息删除（批量删除）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>送货单信息删除</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/del_delivery_ship</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>ids</td>
<td>是</td>
<td>否</td>
<td>送货单id (多个逗号分隔)</td>
<td>integer</td>
<td>1,2,3</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">删除送货单商品（批量删除）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>删除送货单商品</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/del_delivery_goods</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>goods_ids</td>
<td>是</td>
<td>否</td>
<td>商品id (多个逗号分隔)</td>
<td>integer</td>
<td>1,2,3</td>
</tr>
<tr>
<td>delivery_id</td>
<td>是</td>
<td>否</td>
<td>送货单id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">送货单信息查询</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>送货单信息查询</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/delivery_ship_info</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>delivery_id</td>
<td>是</td>
<td>否</td>
<td>送货单id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 1,//送货单id
        &quot;main_id&quot;: 4637, //主账号id
        &quot;user_id&quot;: 4637, //操作人id
        &quot;delivery_no&quot;: &quot;F46371658972770016&quot;,//送货单号
        &quot;consignee&quot;: &quot;王九9999&quot;,//提货人
        &quot;consignee_phone&quot;: &quot;17681130888&quot;,//提货人联系电话
        &quot;consignee_address&quot;: &quot;安徽合肥999&quot;,//提货人地址
        &quot;remark&quot;: &quot;好的很999&quot;,//备注
        &quot;order_time&quot;: &quot;2022&quot;,//下单时间 
        &quot;total_cost&quot;: &quot;100000.000000&quot;,//总费用
        &quot;total_cost_dx&quot;: &quot;十万&quot;,//总费用大写
        &quot;deliver_person&quot;: &quot;张三&quot;,//发货人
        &quot;customer_signature&quot;: &quot;李四&quot;,//客户签字      
        &quot;created_at&quot;: &quot;2022-07-28 13:43:27&quot;,//创建时间
        &quot;updated_at&quot;: &quot;1970-01-01 08:33:42&quot;,//更新时间
        &quot;goods_list&quot;: [
            {
                &quot;id&quot;: 1,
                &quot;delivery_id&quot;: 1,//送货单id
                &quot;main_id&quot;: 4637,
                &quot;user_id&quot;: 4637,
                &quot;name&quot;: &quot;葡萄11&quot;,//商品名称
                &quot;type_name&quot;: &quot;紫11&quot;,//商品规格
                &quot;product_unit&quot;: &quot;件&quot;,//商品单位
                &quot;price&quot;: &quot;5.611000&quot;,//单价
                &quot;num&quot;: 1011,    //商品数量
                &quot;number_parcels&quot;: 5,//包裹件数
                &quot;serial_number&quot;: 11,//序号
                &quot;created_at&quot;: null,//创建时间
                &quot;updated_at&quot;: &quot;2022-07-28 13:57:09&quot;//更新时间
            },
            ......
        ]
    }
}
</code></pre><h2 id="-">送货单信息列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>送货单信息列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/delivery_ship_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>page_size</td>
<td>是</td>
<td>否</td>
<td>分页个数</td>
<td>integer</td>
<td>15</td>
</tr>
<tr>
<td>current_page</td>
<td>是</td>
<td>否</td>
<td>当前页码</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>否</td>
<td>关键词查询</td>
<td>string</td>
<td>掌上网络</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
            {
                 &quot;id&quot;: 1,//送货单id
                &quot;main_id&quot;: 4637, //主账号id
                &quot;user_id&quot;: 4637, //操作人id
                &quot;delivery_no&quot;: &quot;F46371658972770016&quot;,//送货单号
                &quot;consignee&quot;: &quot;王九9999&quot;,//提货人
                &quot;consignee_phone&quot;: &quot;17681130888&quot;,//提货人联系电话
                &quot;consignee_address&quot;: &quot;安徽合肥999&quot;,//提货人地址
                &quot;remark&quot;: &quot;好的很999&quot;,//备注
                &quot;order_time&quot;: &quot;2022&quot;,//下单时间 
                &quot;total_cost&quot;: &quot;100000.000000&quot;,//总费用
                &quot;total_cost_dx&quot;: &quot;十万&quot;,//总费用大写
                &quot;deliver_person&quot;: &quot;张三&quot;,//发货人
                &quot;customer_signature&quot;: &quot;李四&quot;,//客户签字      
                &quot;created_at&quot;: &quot;2022-07-28 13:43:27&quot;,//创建时间
                &quot;updated_at&quot;: &quot;1970-01-01 08:33:42&quot;,//更新时间
                &quot;goods_info&quot;: [
                    {
                          &quot;id&quot;: 1,//商品id
                        &quot;delivery_id&quot;: 1,//送货单id
                        &quot;main_id&quot;: 4637,
                        &quot;user_id&quot;: 4637,
                        &quot;name&quot;: &quot;葡萄11&quot;,//商品名称
                        &quot;type_name&quot;: &quot;紫11&quot;,//商品规格
                        &quot;product_unit&quot;: &quot;件&quot;,//商品单位
                        &quot;price&quot;: &quot;5.611000&quot;,//单价
                        &quot;num&quot;: 1011,    //商品数量
                        &quot;number_parcels&quot;: 5,//包裹件数
                        &quot;serial_number&quot;: 11,//序号
                        &quot;created_at&quot;: null,//创建时间
                        &quot;updated_at&quot;: &quot;2022-07-28 13:57:09&quot;//更新时间
                    },
                    ......
                ]
            },
           ......
        ],
       ....
        &quot;next_page_url&quot;: null,        
        &quot;total&quot;: 7
    }
}
</code></pre><h2 id="-token-">送货单信息查询（分享和打印、不用token）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>送货单信息查询</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/delivery_info</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>delivery_id</td>
<td>是</td>
<td>否</td>
<td>送货单id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 1,//送货单id
        &quot;main_id&quot;: 4637, //主账号id
        &quot;user_id&quot;: 4637, //操作人id
        &quot;delivery_no&quot;: &quot;F46371658972770016&quot;,//送货单号
        &quot;consignee&quot;: &quot;王九9999&quot;,//提货人
        &quot;consignee_phone&quot;: &quot;17681130888&quot;,//提货人联系电话
        &quot;consignee_address&quot;: &quot;安徽合肥999&quot;,//提货人地址
        &quot;remark&quot;: &quot;好的很999&quot;,//备注
        &quot;order_time&quot;: &quot;2022&quot;,//下单时间 
        &quot;total_cost&quot;: &quot;100000.000000&quot;,//总费用
        &quot;total_cost_dx&quot;: &quot;十万&quot;,//总费用大写
        &quot;deliver_person&quot;: &quot;张三&quot;,//发货人
        &quot;customer_signature&quot;: &quot;李四&quot;,//客户签字      
        &quot;created_at&quot;: &quot;2022-07-28 13:43:27&quot;,//创建时间
        &quot;updated_at&quot;: &quot;1970-01-01 08:33:42&quot;,//更新时间
        &quot;goods_list&quot;: [
            {
                &quot;id&quot;: 1,
                &quot;delivery_id&quot;: 1,//送货单id
                &quot;main_id&quot;: 4637,
                &quot;user_id&quot;: 4637,
                &quot;name&quot;: &quot;葡萄11&quot;,//商品名称
                &quot;type_name&quot;: &quot;紫11&quot;,//商品规格
                &quot;product_unit&quot;: &quot;件&quot;,//商品单位
                &quot;price&quot;: &quot;5.611000&quot;,//单价
                &quot;num&quot;: 1011,    //商品数量
                &quot;number_parcels&quot;: 5,//包裹件数
                &quot;serial_number&quot;: 11,//序号
                &quot;created_at&quot;: null,//创建时间
                &quot;updated_at&quot;: &quot;2022-07-28 13:57:09&quot;//更新时间
            },
            ......
        ]
    }
}
</code></pre><h2 id="-">报价单新建</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>报价单信息添加</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/add_quotation_no</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>quotation_no</td>
<td>否</td>
<td>否</td>
<td>报价单流水号（为空时，后台生成）</td>
<td>string</td>
<td>243235423523</td>
</tr>
<tr>
<td>offer_company</td>
<td>否</td>
<td>否</td>
<td>报价公司</td>
<td>string</td>
<td>掌上网络有限公司</td>
</tr>
<tr>
<td>customer_name</td>
<td>否</td>
<td>否</td>
<td>客户名称</td>
<td>string</td>
<td>王五</td>
</tr>
<tr>
<td>customer_phone</td>
<td>否</td>
<td>否</td>
<td>客户联系电话</td>
<td>string</td>
<td>17681138888</td>
</tr>
<tr>
<td>customer_address</td>
<td>否</td>
<td>否</td>
<td>客户地址</td>
<td>string</td>
<td>安徽蚌埠</td>
</tr>
<tr>
<td>total_cost</td>
<td>否</td>
<td>否</td>
<td>本单合计</td>
<td>string</td>
<td>100000</td>
</tr>
<tr>
<td>down_payment</td>
<td>否</td>
<td>否</td>
<td>预付定金</td>
<td>string</td>
<td>10000</td>
</tr>
<tr>
<td>preferential_price</td>
<td>否</td>
<td>否</td>
<td>优惠价</td>
<td>string</td>
<td>10000</td>
</tr>
<tr>
<td>balance_payment</td>
<td>否</td>
<td>否</td>
<td>尾款</td>
<td>string</td>
<td>80000</td>
</tr>
<tr>
<td>announcements</td>
<td>否</td>
<td>否</td>
<td>注意事项</td>
<td>string</td>
<td>不要下水游泳</td>
</tr>
<tr>
<td>tabel_time</td>
<td>否</td>
<td>否</td>
<td>下单时间</td>
<td>string</td>
<td>2022-07-28 09:29:00</td>
</tr>
<tr>
<td>tag_list</td>
<td>否</td>
<td>否</td>
<td>商品和标签信息包</td>
<td>array</td>
<td>[{&quot;tag_name&quot;:&quot;掌上网络01&quot;,&quot;goods_list&quot;:[{&quot;name&quot;:&quot;苹果&quot;,&quot;type_name&quot;:&quot;红&quot;,&quot;product_unit&quot;:&quot;件&quot;,&quot;price&quot;:&quot;5.6&quot;,&quot;num&quot;:&quot;10&quot;,&quot;remark&quot;:&quot;好吃的很&quot;,&quot;serial_number&quot;:11,&quot;goods_img&quot;:&quot;214124.png&quot;},{&quot;name&quot;:&quot;水梨&quot;,&quot;type_name&quot;:&quot;黄&quot;,&quot;product_unit&quot;:&quot;件&quot;,&quot;price&quot;:&quot;3.6&quot;,&quot;num&quot;:&quot;8&quot;,&quot;remark&quot;:&quot;好吃的很&quot;,&quot;serial_number&quot;:22,&quot;goods_img&quot;:&quot;56757.png&quot;}]},{&quot;tag_name&quot;:&quot;掌上网络02&quot;,&quot;goods_list&quot;:[{&quot;name&quot;:&quot;苹果&quot;,&quot;type_name&quot;:&quot;红&quot;,&quot;product_unit&quot;:&quot;件&quot;,&quot;price&quot;:&quot;5.6&quot;,&quot;num&quot;:&quot;10&quot;,&quot;remark&quot;:&quot;好吃的很&quot;,&quot;serial_number&quot;:11,&quot;goods_img&quot;:&quot;214124.png&quot;},{&quot;name&quot;:&quot;水梨&quot;,&quot;type_name&quot;:&quot;黄&quot;,&quot;product_unit&quot;:&quot;件&quot;,&quot;price&quot;:&quot;3.6&quot;,&quot;num&quot;:&quot;8&quot;,&quot;remark&quot;:&quot;好吃的很&quot;,&quot;serial_number&quot;:22,&quot;goods_img&quot;:&quot;56757.png&quot;}]}]</td>
</tr>
<tr>
<td>tag_name</td>
<td>否</td>
<td>否</td>
<td>标签（商品信息包里包括）</td>
<td>string</td>
<td>掌上网络</td>
</tr>
<tr>
<td>goods_list</td>
<td>否</td>
<td>否</td>
<td>商品数据包（商品信息包里包括）</td>
<td>string</td>
<td>商品信息包</td>
</tr>
<tr>
<td>name</td>
<td>否</td>
<td>否</td>
<td>商品名称（商品信息包里包括）</td>
<td>string</td>
<td>葡萄</td>
</tr>
<tr>
<td>type_name</td>
<td>否</td>
<td>否</td>
<td>商品规格（商品信息包里包括）</td>
<td>string</td>
<td>G000088888</td>
</tr>
<tr>
<td>product_unit</td>
<td>否</td>
<td>否</td>
<td>商品单位（商品信息包里包括）</td>
<td>string</td>
<td>件</td>
</tr>
<tr>
<td>price</td>
<td>否</td>
<td>否</td>
<td>单价 （商品信息包里包括）</td>
<td>string</td>
<td>9.6</td>
</tr>
<tr>
<td>num</td>
<td>否</td>
<td>否</td>
<td>商品数量 （商品信息包里包括）</td>
<td>string</td>
<td>10</td>
</tr>
<tr>
<td>number_parcels</td>
<td>否</td>
<td>否</td>
<td>包裹件数（商品信息包里包括）</td>
<td>string</td>
<td>10</td>
</tr>
<tr>
<td>goods_img</td>
<td>否</td>
<td>否</td>
<td>商品图片（商品信息包里包括）</td>
<td>string</td>
<td>12342134.png</td>
</tr>
<tr>
<td>serial_number</td>
<td>否</td>
<td>否</td>
<td>序号（商品信息包里包括）</td>
<td>string</td>
<td>1</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>商品描述（商品信息包里包括）</td>
<td>string</td>
<td>掌上网络是一家软件开发公司</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-08-09 9:30`:增加请求参数`tag_list、tag_name、goods_list` 。删除了请求参数:`goods_label`
</code></pre></blockquote>
<h2 id="-">报价单修改</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>报价单修改</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/upd_quotation_no</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>quotation_id</td>
<td>是</td>
<td>否</td>
<td>报价单id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>offer_company</td>
<td>否</td>
<td>否</td>
<td>报价公司</td>
<td>string</td>
<td>掌上网络有限公司</td>
</tr>
<tr>
<td>customer_name</td>
<td>否</td>
<td>否</td>
<td>客户名称</td>
<td>string</td>
<td>王五</td>
</tr>
<tr>
<td>customer_phone</td>
<td>否</td>
<td>否</td>
<td>客户联系电话</td>
<td>string</td>
<td>17681138888</td>
</tr>
<tr>
<td>customer_address</td>
<td>否</td>
<td>否</td>
<td>客户地址</td>
<td>string</td>
<td>安徽蚌埠</td>
</tr>
<tr>
<td>total_cost</td>
<td>否</td>
<td>否</td>
<td>本单合计</td>
<td>string</td>
<td>100000</td>
</tr>
<tr>
<td>down_payment</td>
<td>否</td>
<td>否</td>
<td>预付定金</td>
<td>string</td>
<td>10000</td>
</tr>
<tr>
<td>preferential_price</td>
<td>否</td>
<td>否</td>
<td>优惠价</td>
<td>string</td>
<td>10000</td>
</tr>
<tr>
<td>balance_payment</td>
<td>否</td>
<td>否</td>
<td>尾款</td>
<td>string</td>
<td>80000</td>
</tr>
<tr>
<td>announcements</td>
<td>否</td>
<td>否</td>
<td>注意事项</td>
<td>string</td>
<td>不要下水游泳</td>
</tr>
<tr>
<td>tabel_time</td>
<td>否</td>
<td>否</td>
<td>下单时间</td>
<td>string</td>
<td>2022-07-28 09:29:00</td>
</tr>
<tr>
<td>tag_list</td>
<td>否</td>
<td>否</td>
<td>商品和标签信息包（可追加）</td>
<td>array</td>
<td>[{&quot;tag_id&quot;:1,&quot;tag_name&quot;:&quot;掌上网络0999&quot;,&quot;goods_list&quot;:[{&quot;goods_id&quot;:1,&quot;name&quot;:&quot;苹果99997777&quot;,&quot;type_name&quot;:&quot;红&quot;,&quot;product_unit&quot;:&quot;件&quot;,&quot;price&quot;:&quot;5.6&quot;,&quot;num&quot;:&quot;10&quot;,&quot;remark&quot;:&quot;好吃的很&quot;,&quot;serial_number&quot;:11,&quot;goods_img&quot;:&quot;214124.png&quot;},{&quot;name&quot;:&quot;水梨&quot;,&quot;type_name&quot;:&quot;黄&quot;,&quot;product_unit&quot;:&quot;件&quot;,&quot;price&quot;:&quot;3.6&quot;,&quot;num&quot;:&quot;8&quot;,&quot;remark&quot;:&quot;好吃的很&quot;,&quot;serial_number&quot;:22,&quot;goods_img&quot;:&quot;56757.png&quot;}]},{&quot;tag_id&quot;:2,&quot;tag_name&quot;:&quot;掌上网络09999&quot;,&quot;goods_list&quot;:[{&quot;goods_id&quot;:2,&quot;name&quot;:&quot;苹果99997777&quot;,&quot;type_name&quot;:&quot;红&quot;,&quot;product_unit&quot;:&quot;件&quot;,&quot;price&quot;:&quot;5.6&quot;,&quot;num&quot;:&quot;10&quot;,&quot;remark&quot;:&quot;好吃的很&quot;,&quot;serial_number&quot;:11,&quot;goods_img&quot;:&quot;214124.png&quot;},{&quot;name&quot;:&quot;水梨&quot;,&quot;type_name&quot;:&quot;黄&quot;,&quot;product_unit&quot;:&quot;件&quot;,&quot;price&quot;:&quot;3.6&quot;,&quot;num&quot;:&quot;8&quot;,&quot;remark&quot;:&quot;好吃的很&quot;,&quot;serial_number&quot;:22,&quot;goods_img&quot;:&quot;56757.png&quot;}]},{&quot;tag_name&quot;:&quot;掌上网络09999&quot;,&quot;goods_list&quot;:[{&quot;name&quot;:&quot;苹果99997777&quot;,&quot;type_name&quot;:&quot;红&quot;,&quot;product_unit&quot;:&quot;件&quot;,&quot;price&quot;:&quot;5.6&quot;,&quot;num&quot;:&quot;10&quot;,&quot;remark&quot;:&quot;好吃的很&quot;,&quot;serial_number&quot;:11,&quot;goods_img&quot;:&quot;214124.png&quot;},{&quot;name&quot;:&quot;水梨&quot;,&quot;type_name&quot;:&quot;黄&quot;,&quot;product_unit&quot;:&quot;件&quot;,&quot;price&quot;:&quot;3.6&quot;,&quot;num&quot;:&quot;8&quot;,&quot;remark&quot;:&quot;好吃的很&quot;,&quot;serial_number&quot;:22,&quot;goods_img&quot;:&quot;56757.png&quot;}]}]</td>
</tr>
<tr>
<td>tag_id</td>
<td>否</td>
<td>否</td>
<td>标签id（商品信息包里包括）</td>
<td>string</td>
<td>1</td>
</tr>
<tr>
<td>tag_name</td>
<td>否</td>
<td>否</td>
<td>标签（商品信息包里包括）</td>
<td>string</td>
<td>掌上网络</td>
</tr>
<tr>
<td>goods_list</td>
<td>否</td>
<td>否</td>
<td>商品数据包（商品信息包里包括（可追加））</td>
<td>string</td>
<td>商品信息包</td>
</tr>
<tr>
<td>goods_id</td>
<td>是</td>
<td>否</td>
<td>商品id（商品信息包里包括）</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>name</td>
<td>否</td>
<td>否</td>
<td>商品名称（商品信息包里包括）</td>
<td>string</td>
<td>葡萄</td>
</tr>
<tr>
<td>type_name</td>
<td>否</td>
<td>否</td>
<td>商品规格（商品信息包里包括）</td>
<td>string</td>
<td>G000088888</td>
</tr>
<tr>
<td>product_unit</td>
<td>否</td>
<td>否</td>
<td>商品单位（商品信息包里包括）</td>
<td>string</td>
<td>件</td>
</tr>
<tr>
<td>price</td>
<td>否</td>
<td>否</td>
<td>单价 （商品信息包里包括）</td>
<td>string</td>
<td>9.6</td>
</tr>
<tr>
<td>num</td>
<td>否</td>
<td>否</td>
<td>商品数量 （商品信息包里包括）</td>
<td>string</td>
<td>10</td>
</tr>
<tr>
<td>number_parcels</td>
<td>否</td>
<td>否</td>
<td>包裹件数（商品信息包里包括）</td>
<td>string</td>
<td>10</td>
</tr>
<tr>
<td>goods_img</td>
<td>否</td>
<td>否</td>
<td>商品图片（商品信息包里包括）</td>
<td>string</td>
<td>12342134.png</td>
</tr>
<tr>
<td>serial_number</td>
<td>否</td>
<td>否</td>
<td>序号（商品信息包里包括）</td>
<td>string</td>
<td>1</td>
</tr>
<tr>
<td>goods_label</td>
<td>否</td>
<td>否</td>
<td>标签（商品信息包里包括）</td>
<td>string</td>
<td>掌上网络</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>商品描述（商品信息包里包括）</td>
<td>string</td>
<td>掌上网络是一家软件开发公司</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-08-09 9:30`:增加请求参数`tag_id、tag_list、tag_name、goods_list` 。删除了请求参数:`goods_label`
</code></pre></blockquote>
<h2 id="-">报价单删除（批量删除）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>报价单删除</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/del_quotation_no</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>ids</td>
<td>是</td>
<td>否</td>
<td>报价单id (多个逗号分隔)</td>
<td>integer</td>
<td>1,2,3</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">删除报价单里商品（批量删除）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>报价单商品删除</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/del_quotation_goods</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>goods_ids</td>
<td>是</td>
<td>否</td>
<td>商品id (多个逗号分隔)</td>
<td>integer</td>
<td>1,2,3</td>
</tr>
<tr>
<td>quotation_id</td>
<td>是</td>
<td>否</td>
<td>报价单id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">删除报价单标签及商品（批量删除）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>报价单标签及商品删除</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/del_quotation_tags</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>tag_ids</td>
<td>是</td>
<td>否</td>
<td>标签id (多个逗号分隔)</td>
<td>integer</td>
<td>1,2,3</td>
</tr>
<tr>
<td>quotation_id</td>
<td>是</td>
<td>否</td>
<td>报价单id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">报价单信息查询</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>报价单信息查询</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/quotation_no_info</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>quotation_id</td>
<td>是</td>
<td>否</td>
<td>报价单id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 2,//报价单id
        &quot;main_id&quot;: 4637,
        &quot;user_id&quot;: 4637,
        &quot;quotation_no&quot;: &quot;F46371659085524600&quot;,//报价单流水号
        &quot;offer_company&quot;: &quot;掌上科技9999&quot;,//报价公司
        &quot;customer_name&quot;: &quot;张马宇9999&quot;,//客户名称
        &quot;customer_phone&quot;: &quot;17681130165&quot;,//客户联系电话
        &quot;customer_address&quot;: &quot;安徽蚌埠&quot;,//客户地址
        &quot;total_cost&quot;: &quot;100000.000000&quot;,//本单合计
        &quot;down_payment&quot;: &quot;50000.000000&quot;,//预付定金
        &quot;preferential_price&quot;: &quot;20000.000000&quot;,//优惠价
        &quot;balance_payment&quot;: &quot;30000.000000&quot;,//尾款
        &quot;announcements&quot;: &quot;好的很的很&quot;,//注意事项
        &quot;tabel_time&quot;: &quot;2022-07-28 09:29:00&quot;,//出表时间
        &quot;created_at&quot;: &quot;2022-07-29 17:05:24&quot;,
        &quot;updated_at&quot;: &quot;2022-08-01 15:01:38&quot;,
        &quot;tag_list&quot;: [
            {
                &quot;name&quot;: &quot;掌上网络01&quot;,
                &quot;goods_list&quot;: [
                    {    
                &quot;id&quot;: 1,
                &quot;quotation_id&quot;: 2,//报价单id
                &quot;main_id&quot;: 4637,
                &quot;user_id&quot;: 4637,
                &quot;name&quot;: &quot;葡萄11&quot;,//商品名称
                &quot;type_name&quot;: &quot;紫11&quot;,//商品规格
                &quot;product_unit&quot;: &quot;件&quot;,//商品单位
                &quot;goods_img&quot;: &quot;111111.png&quot;,//商品图片
                &quot;price&quot;: &quot;5.611000&quot;,//单价
                &quot;num&quot;: 1011,//商品数量
                &quot;remark&quot;: 0,//商品备注
                &quot;serial_number&quot;: 11,//序号
               &quot;tag_id&quot;: 3,//商品标签id
                &quot;created_at&quot;: &quot;2022-07-29 17:05:24&quot;,
                &quot;updated_at&quot;: &quot;2022-08-01 15:01:37&quot;
                    },
                    ......
                ]
            },
            ......
                ]                    
    }
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-08-09 9:30`:增加返回参数`tag_id、tag_list、tag_name、goods_list` 。删除了返回参数:`goods_label`
</code></pre></blockquote>
<h2 id="-">报价单信息列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>报价单信息列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/quotation_no_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>page_size</td>
<td>是</td>
<td>否</td>
<td>分页个数</td>
<td>integer</td>
<td>15</td>
</tr>
<tr>
<td>current_page</td>
<td>是</td>
<td>否</td>
<td>当前页码</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>否</td>
<td>关键词查询</td>
<td>string</td>
<td>掌上网络</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
            {
                &quot;id&quot;: 2,//报价单id
                &quot;main_id&quot;: 4637,
                &quot;user_id&quot;: 4637,
                &quot;quotation_no&quot;: &quot;F46371659085524600&quot;,//报价单流水号
                &quot;offer_company&quot;: &quot;掌上科技9999&quot;,//报价公司
                &quot;customer_name&quot;: &quot;张马宇9999&quot;,//客户名称
                &quot;customer_phone&quot;: &quot;17681130165&quot;,//客户联系电话
                &quot;customer_address&quot;: &quot;安徽蚌埠&quot;,//客户地址
                &quot;total_cost&quot;: &quot;100000.000000&quot;,//本单合计
                &quot;down_payment&quot;: &quot;50000.000000&quot;,//预付定金
                &quot;preferential_price&quot;: &quot;20000.000000&quot;,//优惠价
                &quot;balance_payment&quot;: &quot;30000.000000&quot;,//尾款
                &quot;announcements&quot;: &quot;好的很的很&quot;,//注意事项
                &quot;tabel_time&quot;: &quot;2022-07-28 09:29:00&quot;,//出表时间
                &quot;created_at&quot;: &quot;2022-07-29 17:05:24&quot;,
                &quot;updated_at&quot;: &quot;2022-08-01 15:01:38&quot;,                
                &quot;tag_list&quot;: [
                    {
                        &quot;id&quot;: 3,//标签id 
                        &quot;tag_name&quot;: &quot;掌上网络01&quot;,//标签名称
                        &quot;goods_list&quot;: [
                            {
                                &quot;id&quot;: 1,
                                &quot;quotation_id&quot;: 2,//报价单id
                                &quot;main_id&quot;: 4637,
                                &quot;user_id&quot;: 4637,
                                &quot;name&quot;: &quot;葡萄11&quot;,//商品名称
                                &quot;type_name&quot;: &quot;紫11&quot;,//商品规格
                                &quot;product_unit&quot;: &quot;件&quot;,//商品单位
                                &quot;goods_img&quot;: &quot;111111.png&quot;,//商品图片
                                &quot;price&quot;: &quot;5.611000&quot;,//单价
                                &quot;num&quot;: 1011,//商品数量
                                &quot;remark&quot;: 0,//商品备注
                                &quot;serial_number&quot;: 11,//序号
                                   &quot;tag_id&quot;: 3,//商品标签id
                                &quot;created_at&quot;: &quot;2022-07-29 17:05:24&quot;,
                                &quot;updated_at&quot;: &quot;2022-08-01 15:01:37&quot;
                            },
                            ......
                            ]
                        },
                        ......
                        ]
            },
           ......
        ],
       ....
        &quot;next_page_url&quot;: null,        
        &quot;total&quot;: 7
    }
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-08-09 9:30`:增加返回参数`tag_id、tag_list、tag_name、goods_list` 。删除了返回参数:`goods_label`
</code></pre></blockquote>
<h2 id="-token-">报价单信息查询（分享和打印、不用token）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>报价单信息查询</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/quotation_info</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>quotation_id</td>
<td>是</td>
<td>否</td>
<td>报价单id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 2,//报价单id
        &quot;main_id&quot;: 4637,
        &quot;user_id&quot;: 4637,
        &quot;quotation_no&quot;: &quot;F46371659085524600&quot;,//报价单流水号
        &quot;offer_company&quot;: &quot;掌上科技9999&quot;,//报价公司
        &quot;customer_name&quot;: &quot;张马宇9999&quot;,//客户名称
        &quot;customer_phone&quot;: &quot;17681130165&quot;,//客户联系电话
        &quot;customer_address&quot;: &quot;安徽蚌埠&quot;,//客户地址
        &quot;total_cost&quot;: &quot;100000.000000&quot;,//本单合计
        &quot;down_payment&quot;: &quot;50000.000000&quot;,//预付定金
        &quot;preferential_price&quot;: &quot;20000.000000&quot;,//优惠价
        &quot;balance_payment&quot;: &quot;30000.000000&quot;,//尾款
        &quot;announcements&quot;: &quot;好的很的很&quot;,//注意事项
        &quot;tabel_time&quot;: &quot;2022-07-28 09:29:00&quot;,//出表时间
        &quot;created_at&quot;: &quot;2022-07-29 17:05:24&quot;,
        &quot;updated_at&quot;: &quot;2022-08-01 15:01:38&quot;,
        &quot;tag_list&quot;: [
            {
                &quot;name&quot;: &quot;掌上网络01&quot;,
                &quot;goods_list&quot;: [
                    {    
                &quot;id&quot;: 1,
                &quot;quotation_id&quot;: 2,//报价单id
                &quot;main_id&quot;: 4637,
                &quot;user_id&quot;: 4637,
                &quot;name&quot;: &quot;葡萄11&quot;,//商品名称
                &quot;type_name&quot;: &quot;紫11&quot;,//商品规格
                &quot;product_unit&quot;: &quot;件&quot;,//商品单位
                &quot;goods_img&quot;: &quot;111111.png&quot;,//商品图片
                &quot;price&quot;: &quot;5.611000&quot;,//单价
                &quot;num&quot;: 1011,//商品数量
                &quot;remark&quot;: 0,//商品备注
                &quot;serial_number&quot;: 11,//序号
               &quot;tag_id&quot;: 3,//商品标签id
                &quot;created_at&quot;: &quot;2022-07-29 17:05:24&quot;,
                &quot;updated_at&quot;: &quot;2022-08-01 15:01:37&quot;
                    },
                    ......
                ]
            },
            ......
                ]                    
    }
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-08-09 9:30`:增加返回参数`tag_id、tag_list、tag_name、goods_list` 。删除了返回参数:`goods_label`
</code></pre></blockquote>
<h2 id="-">报价单-商品图片上传（单个）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>报价单信息查询</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/upload_goods_img</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>goods_img</td>
<td>是</td>
<td>否</td>
<td>报价单-商品图片</td>
<td>file</td>
<td>图片文件数据包</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
      &quot;path&quot;:&quot;/upload/goods-img/2022-08-02/2143214321412.png&quot;
    }
}
</code></pre><h2 id="-">收据新建</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>收据添加</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/add_receipt</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>receipt_no</td>
<td>否</td>
<td>否</td>
<td>收据单号（为空时，后台生成）</td>
<td>string</td>
<td>NO.8888888</td>
</tr>
<tr>
<td>date_recorded</td>
<td>否</td>
<td>否</td>
<td>入账时间</td>
<td>string</td>
<td>2022-07-28 09:29:00</td>
</tr>
<tr>
<td>receive</td>
<td>否</td>
<td>否</td>
<td>收到</td>
<td>string</td>
<td>收到了</td>
</tr>
<tr>
<td>amount_in_words</td>
<td>否</td>
<td>否</td>
<td>大写金额</td>
<td>string</td>
<td>壹佰万</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>掌上网络是一家软件开发公司</td>
</tr>
<tr>
<td>money</td>
<td>否</td>
<td>否</td>
<td>金额</td>
<td>string</td>
<td>100000</td>
</tr>
<tr>
<td>unit_stamp</td>
<td>否</td>
<td>否</td>
<td>单位盖章</td>
<td>string/file</td>
<td>4141.png</td>
</tr>
<tr>
<td>accountant</td>
<td>否</td>
<td>否</td>
<td>会计</td>
<td>string</td>
<td>张三</td>
</tr>
<tr>
<td>teller</td>
<td>否</td>
<td>否</td>
<td>出纳</td>
<td>string</td>
<td>李四</td>
</tr>
<tr>
<td>handling_person</td>
<td>否</td>
<td>否</td>
<td>经手人</td>
<td>string</td>
<td>王二麻</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">收据修改</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>收据修改</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/upd_receipt</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>receipt_id</td>
<td>是</td>
<td>否</td>
<td>收据id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>receipt_no</td>
<td>否</td>
<td>否</td>
<td>收据单号（为空时，后台生成）</td>
<td>string</td>
<td>NO.8888888</td>
</tr>
<tr>
<td>date_recorded</td>
<td>否</td>
<td>否</td>
<td>入账时间</td>
<td>string</td>
<td>2022-07-28 09:29:00</td>
</tr>
<tr>
<td>receive</td>
<td>否</td>
<td>否</td>
<td>收到</td>
<td>string</td>
<td>收到了</td>
</tr>
<tr>
<td>amount_in_words</td>
<td>否</td>
<td>否</td>
<td>大写金额</td>
<td>string</td>
<td>壹佰万</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>掌上网络是一家软件开发公司</td>
</tr>
<tr>
<td>money</td>
<td>否</td>
<td>否</td>
<td>金额</td>
<td>string</td>
<td>100000</td>
</tr>
<tr>
<td>unit_stamp</td>
<td>否</td>
<td>否</td>
<td>单位盖章</td>
<td>string/file</td>
<td>4141.png</td>
</tr>
<tr>
<td>accountant</td>
<td>否</td>
<td>否</td>
<td>会计</td>
<td>string</td>
<td>张三</td>
</tr>
<tr>
<td>teller</td>
<td>否</td>
<td>否</td>
<td>出纳</td>
<td>string</td>
<td>李四</td>
</tr>
<tr>
<td>handling_person</td>
<td>否</td>
<td>否</td>
<td>经手人</td>
<td>string</td>
<td>王二麻</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">收据删除（批量删除）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>收据删除</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/del_receipt</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>ids</td>
<td>是</td>
<td>否</td>
<td>收据id (多个逗号分隔)</td>
<td>integer</td>
<td>1,2,3</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">收据信息查询</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>收据信息查询</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/receipt_info</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>receipt_id</td>
<td>是</td>
<td>否</td>
<td>收据id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 1,//收据id
        &quot;main_id&quot;: 4637,
        &quot;user_id&quot;: 4637,
        &quot;receipt_no&quot;: &quot;F46371659148124881&quot;,//收据单号
        &quot;date_recorded&quot;: &quot;2022-07-28 09:29:00&quot;,//入账时间 
        &quot;receive&quot;: &quot;收到了，谢谢&quot;,//收到
        &quot;amount_in_words&quot;: &quot;十万&quot;,//大写金额
        &quot;remark&quot;: &quot;好的很&quot;,//备注
        &quot;money&quot;: &quot;50000.000000&quot;,//金额
        &quot;unit_stamp&quot;: &quot;1231.png&quot;,//单位盖章
        &quot;accountant&quot;: &quot;张玉&quot;,//会计
        &quot;teller&quot;: &quot;张马宇&quot;,//出纳
        &quot;handling_person&quot;: &quot;马宇&quot;,//经手人
        &quot;created_at&quot;: &quot;2022-07-30 10:28:44&quot;,
        &quot;updated_at&quot;: null
    }
}
</code></pre><h2 id="-">收据信息列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>收据信息列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/receipt_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>page_size</td>
<td>是</td>
<td>否</td>
<td>分页个数</td>
<td>integer</td>
<td>15</td>
</tr>
<tr>
<td>current_page</td>
<td>是</td>
<td>否</td>
<td>当前页码</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>否</td>
<td>关键词查询</td>
<td>string</td>
<td>掌上网络</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
            { 
                &quot;id&quot;: 1,//收据id
                &quot;main_id&quot;: 4637,
                &quot;user_id&quot;: 4637,
                &quot;receipt_no&quot;: &quot;F46371659148124881&quot;,//收据单号
                &quot;date_recorded&quot;: &quot;2022-07-28 09:29:00&quot;,//入账时间 
                &quot;receive&quot;: &quot;收到了，谢谢&quot;,//收到
                &quot;amount_in_words&quot;: &quot;十万&quot;,//大写金额
                &quot;remark&quot;: &quot;好的很&quot;,//备注
                &quot;money&quot;: &quot;50000.000000&quot;,//金额
                &quot;unit_stamp&quot;: &quot;1231.png&quot;,//单位盖章
                &quot;accountant&quot;: &quot;张玉&quot;,//会计
                &quot;teller&quot;: &quot;张马宇&quot;,//出纳
                &quot;handling_person&quot;: &quot;马宇&quot;,//经手人
                &quot;created_at&quot;: &quot;2022-07-30 10:28:44&quot;,
                &quot;updated_at&quot;: null
            },
           ......
        ],
       ....
        &quot;next_page_url&quot;: null,        
        &quot;total&quot;: 7
    }
}
</code></pre><h2 id="-token-">收据信息查询（分享和打印、不用token）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>收据信息查询</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/get_info</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>receipt_id</td>
<td>是</td>
<td>否</td>
<td>收据id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
           &quot;id&quot;: 1,//收据id
            &quot;main_id&quot;: 4637,
            &quot;user_id&quot;: 4637,
            &quot;receipt_no&quot;: &quot;F46371659148124881&quot;,//收据单号
            &quot;date_recorded&quot;: &quot;2022-07-28 09:29:00&quot;,//入账时间 
            &quot;receive&quot;: &quot;收到了，谢谢&quot;,//收到
            &quot;amount_in_words&quot;: &quot;十万&quot;,//大写金额
            &quot;remark&quot;: &quot;好的很&quot;,//备注
            &quot;money&quot;: &quot;50000.000000&quot;,//金额
            &quot;unit_stamp&quot;: &quot;1231.png&quot;,//单位盖章
            &quot;accountant&quot;: &quot;张玉&quot;,//会计
            &quot;teller&quot;: &quot;张马宇&quot;,//出纳
            &quot;handling_person&quot;: &quot;马宇&quot;,//经手人
            &quot;created_at&quot;: &quot;2022-07-30 10:28:44&quot;,
            &quot;updated_at&quot;: null 
    }
}
</code></pre><h2 id="-">医疗机械专用送货单添加</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>医疗机械专用送货单添加</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/add_medical_delivery_order</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>customer_name</td>
<td>否</td>
<td>否</td>
<td>客户名称</td>
<td>string</td>
<td>王五</td>
</tr>
<tr>
<td>customer_address</td>
<td>否</td>
<td>否</td>
<td>客户地址</td>
<td>string</td>
<td>安徽蚌埠</td>
</tr>
<tr>
<td>supply_license_no</td>
<td>否</td>
<td>否</td>
<td>供货单位许可证号</td>
<td>string</td>
<td>243235423523</td>
</tr>
<tr>
<td>ticket_code</td>
<td>否</td>
<td>否</td>
<td>发票号</td>
<td>string</td>
<td>3463464356</td>
</tr>
<tr>
<td>total_cost</td>
<td>否</td>
<td>否</td>
<td>总金额</td>
<td>string</td>
<td>100000</td>
</tr>
<tr>
<td>total_cost_dx</td>
<td>否</td>
<td>否</td>
<td>总金额大写</td>
<td>string</td>
<td>十万</td>
</tr>
<tr>
<td>handling_person</td>
<td>否</td>
<td>否</td>
<td>送货经手人</td>
<td>string</td>
<td>李四</td>
</tr>
<tr>
<td>handling_person_iphone</td>
<td>否</td>
<td>否</td>
<td>送货经手人电话</td>
<td>string</td>
<td>17681138888</td>
</tr>
<tr>
<td>delivery_time</td>
<td>否</td>
<td>否</td>
<td>发货时间</td>
<td>string</td>
<td>2022-07-28 09:29:00</td>
</tr>
<tr>
<td>consignee</td>
<td>否</td>
<td>否</td>
<td>收货人</td>
<td>array</td>
<td>小明</td>
</tr>
<tr>
<td>consignee_iphone</td>
<td>否</td>
<td>否</td>
<td>收货人电话</td>
<td>string</td>
<td>17681138888</td>
</tr>
<tr>
<td>receiving_time</td>
<td>否</td>
<td>否</td>
<td>收货日期</td>
<td>string</td>
<td>2022-07-28 09:29:00</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>今天天气真好</td>
</tr>
<tr>
<td>unit_stamp</td>
<td>否</td>
<td>否</td>
<td>单位盖章</td>
<td>string</td>
<td>2142314.png</td>
</tr>
<tr>
<td>goods_info</td>
<td>否</td>
<td>否</td>
<td>商品信息包</td>
<td>array</td>
<td>[{&quot;name&quot;:&quot;葡萄&quot;,&quot;type_name&quot;:&quot;紫&quot;,&quot;product_unit&quot;:&quot;红富士&quot;,&quot;price&quot;:&quot;5.6&quot;,&quot;total_price&quot;:&quot;5.6&quot;,&quot;num&quot;:&quot;10&quot;,&quot;serial_number&quot;:11,&quot;manufacturer&quot;:&quot;掌上网络1&quot;,&quot;batch_number&quot;:&quot;ZS45647547567&quot;,&quot;date_in_produced&quot;:&quot;2022-07-30 21:30:30&quot;,&quot;effective_date&quot;:&quot;2023-07-30 21:30:30&quot;,&quot;storage_condition&quot;:&quot;温度在15度以下&quot;,&quot;registration_number&quot;:&quot;zc3252543253656546&quot;},{&quot;name&quot;:&quot;水梨&quot;,&quot;type_name&quot;:&quot;黄&quot;,&quot;product_unit&quot;:&quot;砀山梨&quot;,&quot;price&quot;:&quot;3.6&quot;,&quot;total_price&quot;:&quot;5.6&quot;,&quot;num&quot;:&quot;8&quot;,&quot;serial_number&quot;:22,&quot;manufacturer&quot;:&quot;掌上网络1&quot;,&quot;batch_number&quot;:&quot;ZS45647547567&quot;,&quot;date_in_produced&quot;:&quot;2022-07-30 21:30:30&quot;,&quot;effective_date&quot;:&quot;2023-07-30 21:30:30&quot;,&quot;storage_condition&quot;:&quot;温度在15度以下&quot;,&quot;registration_number&quot;:&quot;zc3252543253656546&quot;}]</td>
</tr>
<tr>
<td>name</td>
<td>否</td>
<td>否</td>
<td>商品名称（商品信息包里包括）</td>
<td>string</td>
<td>苹果</td>
</tr>
<tr>
<td>type_name</td>
<td>否</td>
<td>否</td>
<td>商品规格 （商品信息包里包括）</td>
<td>string</td>
<td>红</td>
</tr>
<tr>
<td>product_unit</td>
<td>否</td>
<td>否</td>
<td>商品计数单位（商品信息包里包括）</td>
<td>string</td>
<td>件</td>
</tr>
<tr>
<td>price</td>
<td>否</td>
<td>否</td>
<td>单价 （商品信息包里包括）</td>
<td>string</td>
<td>10</td>
</tr>
<tr>
<td>total_price</td>
<td>否</td>
<td>否</td>
<td>总金额 （商品信息包里包括）</td>
<td>string</td>
<td>10</td>
</tr>
<tr>
<td>num</td>
<td>否</td>
<td>否</td>
<td>商品数量 （商品信息包里包括）</td>
<td>string</td>
<td>10</td>
</tr>
<tr>
<td>manufacturer</td>
<td>否</td>
<td>否</td>
<td>生产厂家（商品信息包里包括）</td>
<td>string</td>
<td>红富士</td>
</tr>
<tr>
<td>batch_number</td>
<td>否</td>
<td>否</td>
<td>生产批号（商品信息包里包括）</td>
<td>string</td>
<td>353453425324</td>
</tr>
<tr>
<td>date_in_produced</td>
<td>否</td>
<td>否</td>
<td>生产日期（商品信息包里包括）</td>
<td>string</td>
<td>2022-07-28 09:29:00</td>
</tr>
<tr>
<td>effective_date</td>
<td>否</td>
<td>否</td>
<td>有效时间（商品信息包里包括）</td>
<td>string</td>
<td>2022-07-28 09:29:00</td>
</tr>
<tr>
<td>storage_condition</td>
<td>否</td>
<td>否</td>
<td>存储条件（商品信息包里包括）</td>
<td>string</td>
<td>15度以下</td>
</tr>
<tr>
<td>registration_number</td>
<td>否</td>
<td>否</td>
<td>注册证号（商品信息包里包括）</td>
<td>string</td>
<td>435634634</td>
</tr>
<tr>
<td>serial_number</td>
<td>否</td>
<td>否</td>
<td>序号（商品信息包里包括）</td>
<td>string</td>
<td>242142</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-08-08 17:01`:增加请求参数`total_price`
</code></pre><h2 id="-">医疗机械专用送货单修改</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>医疗机械专用送货单修改</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/upd_medical_delivery_order</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>medical_delivery_id</td>
<td>是</td>
<td>否</td>
<td>医疗机械专用送货单id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>customer_name</td>
<td>否</td>
<td>否</td>
<td>客户名称</td>
<td>string</td>
<td>王五</td>
</tr>
<tr>
<td>customer_address</td>
<td>否</td>
<td>否</td>
<td>客户地址</td>
<td>string</td>
<td>安徽蚌埠</td>
</tr>
<tr>
<td>supply_license_no</td>
<td>否</td>
<td>否</td>
<td>供货单位许可证号</td>
<td>string</td>
<td>243235423523</td>
</tr>
<tr>
<td>ticket_code</td>
<td>否</td>
<td>否</td>
<td>发票号</td>
<td>string</td>
<td>3463464356</td>
</tr>
<tr>
<td>total_cost</td>
<td>否</td>
<td>否</td>
<td>总金额</td>
<td>string</td>
<td>100000</td>
</tr>
<tr>
<td>total_cost_dx</td>
<td>否</td>
<td>否</td>
<td>总金额大写</td>
<td>string</td>
<td>十万</td>
</tr>
<tr>
<td>handling_person</td>
<td>否</td>
<td>否</td>
<td>送货经手人</td>
<td>string</td>
<td>李四</td>
</tr>
<tr>
<td>handling_person_iphone</td>
<td>否</td>
<td>否</td>
<td>送货经手人电话</td>
<td>string</td>
<td>17681138888</td>
</tr>
<tr>
<td>delivery_time</td>
<td>否</td>
<td>否</td>
<td>发货时间</td>
<td>string</td>
<td>2022-07-28 09:29:00</td>
</tr>
<tr>
<td>consignee</td>
<td>否</td>
<td>否</td>
<td>收货人</td>
<td>array</td>
<td>小明</td>
</tr>
<tr>
<td>consignee_iphone</td>
<td>否</td>
<td>否</td>
<td>收货人电话</td>
<td>string</td>
<td>17681138888</td>
</tr>
<tr>
<td>receiving_time</td>
<td>否</td>
<td>否</td>
<td>收货日期</td>
<td>string</td>
<td>2022-07-28 09:29:00</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>今天天气真好</td>
</tr>
<tr>
<td>unit_stamp</td>
<td>否</td>
<td>否</td>
<td>单位盖章</td>
<td>string</td>
<td>2142314.png</td>
</tr>
<tr>
<td>goods_info</td>
<td>否</td>
<td>否</td>
<td>商品信息包(修改时，可以新增商品)</td>
<td>array</td>
<td>[{&quot;goods_id&quot;:1,&quot;name&quot;:&quot;葡萄888&quot;,&quot;type_name&quot;:&quot;紫8888&quot;,&quot;product_unit&quot;:&quot;红富士888&quot;,&quot;price&quot;:&quot;5.611&quot;,&quot;num&quot;:&quot;1011&quot;,&quot;serial_number&quot;:11,&quot;manufacturer&quot;:&quot;掌上网络1&quot;,&quot;batch_number&quot;:&quot;ZS45647547567&quot;,&quot;date_in_produced&quot;:&quot;2022-07-30 21:30:30&quot;,&quot;effective_date&quot;:&quot;2023-07-30 21:30:30&quot;,&quot;storage_condition&quot;:&quot;温度在15度以下&quot;,&quot;registration_number&quot;:&quot;zc3252543253656546&quot;,&quot;total_price&quot;:&quot;666.55&quot;},{&quot;goods_id&quot;:2,&quot;name&quot;:&quot;水梨8888&quot;,&quot;type_name&quot;:&quot;黄888&quot;,&quot;product_unit&quot;:&quot;砀山梨8888&quot;,&quot;price&quot;:&quot;3.6&quot;,&quot;num&quot;:&quot;8&quot;,&quot;serial_number&quot;:22,&quot;manufacturer&quot;:&quot;掌上网络1&quot;,&quot;batch_number&quot;:&quot;ZS45647547567&quot;,&quot;date_in_produced&quot;:&quot;2022-07-30 21:30:30&quot;,&quot;effective_date&quot;:&quot;2023-07-30 21:30:30&quot;,&quot;storage_condition&quot;:&quot;温度在15度以下&quot;,&quot;registration_number&quot;:&quot;zc3252543253656546&quot;,&quot;total_price&quot;:&quot;666.55&quot;},{&quot;name&quot;:&quot;水梨8888&quot;,&quot;type_name&quot;:&quot;黄888&quot;,&quot;product_unit&quot;:&quot;砀山梨888&quot;,&quot;price&quot;:&quot;3.6&quot;,&quot;num&quot;:&quot;8&quot;,&quot;serial_number&quot;:22,&quot;manufacturer&quot;:&quot;掌上网络1&quot;,&quot;batch_number&quot;:&quot;ZS45647547567&quot;,&quot;date_in_produced&quot;:&quot;2022-07-30 21:30:30&quot;,&quot;effective_date&quot;:&quot;2023-07-30 21:30:30&quot;,&quot;storage_condition&quot;:&quot;温度在15度以下&quot;,&quot;registration_number&quot;:&quot;zc3252543253656546&quot;,&quot;total_price&quot;:&quot;666.55&quot;}</td>
</tr>
<tr>
<td>goods_id</td>
<td>是</td>
<td>否</td>
<td>商品id（商品信息包里包括）</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>name</td>
<td>否</td>
<td>否</td>
<td>商品名称（商品信息包里包括）</td>
<td>string</td>
<td>苹果</td>
</tr>
<tr>
<td>type_name</td>
<td>否</td>
<td>否</td>
<td>商品规格 （商品信息包里包括）</td>
<td>string</td>
<td>红</td>
</tr>
<tr>
<td>product_unit</td>
<td>否</td>
<td>否</td>
<td>商品计数单位（商品信息包里包括）</td>
<td>string</td>
<td>件</td>
</tr>
<tr>
<td>price</td>
<td>否</td>
<td>否</td>
<td>单价 （商品信息包里包括）</td>
<td>string</td>
<td>10</td>
</tr>
<tr>
<td>total_price</td>
<td>否</td>
<td>否</td>
<td>总金额 （商品信息包里包括）</td>
<td>string</td>
<td>10</td>
</tr>
<tr>
<td>num</td>
<td>否</td>
<td>否</td>
<td>商品数量 （商品信息包里包括）</td>
<td>string</td>
<td>10</td>
</tr>
<tr>
<td>manufacturer</td>
<td>否</td>
<td>否</td>
<td>生产厂家（商品信息包里包括）</td>
<td>string</td>
<td>红富士</td>
</tr>
<tr>
<td>batch_number</td>
<td>否</td>
<td>否</td>
<td>生产批号（商品信息包里包括）</td>
<td>string</td>
<td>353453425324</td>
</tr>
<tr>
<td>date_in_produced</td>
<td>否</td>
<td>否</td>
<td>生产日期（商品信息包里包括）</td>
<td>string</td>
<td>2022-07-28 09:29:00</td>
</tr>
<tr>
<td>effective_date</td>
<td>否</td>
<td>否</td>
<td>有效时间（商品信息包里包括）</td>
<td>string</td>
<td>2022-07-28 09:29:00</td>
</tr>
<tr>
<td>storage_condition</td>
<td>否</td>
<td>否</td>
<td>存储条件（商品信息包里包括）</td>
<td>string</td>
<td>15度以下</td>
</tr>
<tr>
<td>registration_number</td>
<td>否</td>
<td>否</td>
<td>注册证号（商品信息包里包括）</td>
<td>string</td>
<td>435634634</td>
</tr>
<tr>
<td>serial_number</td>
<td>否</td>
<td>否</td>
<td>序号（商品信息包里包括）</td>
<td>string</td>
<td>242142</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-08-08 17:01`:增加请求参数`total_price`
</code></pre><h2 id="-">医疗机械专用送货单删除（批量删除）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>医疗机械专用送货单删除</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/del_medical_delivery_order</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>ids</td>
<td>是</td>
<td>否</td>
<td>医疗机械专用送货单id (多个逗号分隔)</td>
<td>integer</td>
<td>1,2,3</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">删除医疗机械专用送货单商品（批量删除）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>删除商品</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/del_medical_delivery_goods</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>goods_ids</td>
<td>是</td>
<td>否</td>
<td>商品id (多个逗号分隔)</td>
<td>integer</td>
<td>1,2,3</td>
</tr>
<tr>
<td>medical_delivery_id</td>
<td>是</td>
<td>否</td>
<td>医疗机械专用送货单id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">医疗机械专用送货单信息查询</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>医疗机械专用送货单信息查询</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/medical_delivery_order_info</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>medical_delivery_id</td>
<td>是</td>
<td>否</td>
<td>医疗机械专用送货单id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 2,//医疗机械专用送货单id
        &quot;main_id&quot;: 4637,
        &quot;user_id&quot;: 4637,
        &quot;customer_name&quot;: &quot;王小玟&quot;,//客户名称
        &quot;customer_address&quot;: &quot;安徽合肥&quot;,//客户地址
        &quot;supply_license_no&quot;: &quot;xk325324534667&quot;,//供货单位许可证号
        &quot;ticket_code&quot;: &quot;500089789789&quot;,//发票号
        &quot;total_cost&quot;: &quot;100000.000000&quot;,//总金额
        &quot;total_cost_dx&quot;: &quot;十万&quot;,//总金额大写
        &quot;handling_person&quot;: &quot;李四&quot;,//送货经手人
        &quot;handling_person_iphone&quot;: &quot;17681130165&quot;,//送货经手人电话
        &quot;delivery_time&quot;: &quot;2022-07-28 09:29:00&quot;,//发货时间 
        &quot;consignee&quot;: &quot;张三&quot;,//收货人
        &quot;consignee_iphone&quot;: &quot;17681130165&quot;,//收货人电话
        &quot;receiving_time&quot;: &quot;2022-07-28 09:29:00&quot;,//收货日期
        &quot;remark&quot;: &quot;好的很1111&quot;,//备注
        &quot;unit_stamp&quot;: &quot;3452534.png&quot;,//单位盖章
        &quot;created_at&quot;: &quot;2022-07-30 15:56:10&quot;,
        &quot;updated_at&quot;: null,
        &quot;goods_list&quot;: [
            {
                &quot;id&quot;: 1,//医疗机械专用送货单id
                &quot;medical_delivery_id&quot;: 2,//医疗送货单id
                &quot;main_id&quot;: 4637,
                &quot;user_id&quot;: 4637,
                &quot;name&quot;: &quot;葡萄888&quot;,//商品名称
                &quot;type_name&quot;: &quot;紫8888&quot;,//商品规格
                &quot;product_unit&quot;: &quot;红富士888&quot;,//商品计数单位
                &quot;price&quot;: &quot;5.611000&quot;,//单价
                &quot;num&quot;: 1011,//商品数量
                &quot;manufacturer&quot;: &quot;掌上网络1&quot;,//生产厂家
                &quot;batch_number&quot;: &quot;ZS45647547567&quot;,//生产批号
                &quot;date_in_produced&quot;: &quot;2022-07-30 21:30:30&quot;,//生产日期
                &quot;effective_date&quot;: &quot;2023-07-30 21:30:30&quot;,//有效时间
                &quot;storage_condition&quot;: &quot;温度在15度以下&quot;,//存储条件
                &quot;registration_number&quot;: &quot;zc3252543253656546&quot;,//注册证号
                &quot;serial_number&quot;: 11,//序号
                &quot;created_at&quot;: &quot;2022-07-30 15:56:10&quot;,
                &quot;updated_at&quot;: &quot;2022-08-01 15:02:45&quot;
            },
            ......
        ]
    }
}
</code></pre><h2 id="-">医疗机械专用送货单列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>医疗机械专用送货单列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/get_medical_delivery_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>page_size</td>
<td>是</td>
<td>否</td>
<td>分页个数</td>
<td>integer</td>
<td>15</td>
</tr>
<tr>
<td>current_page</td>
<td>是</td>
<td>否</td>
<td>当前页码</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>否</td>
<td>关键词查询</td>
<td>string</td>
<td>掌上网络</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
            { 
                &quot;id&quot;: 2,//医疗机械专用送货单id
                &quot;main_id&quot;: 4637,
                &quot;user_id&quot;: 4637,
                &quot;customer_name&quot;: &quot;王小玟&quot;,//客户名称
                &quot;customer_address&quot;: &quot;安徽合肥&quot;,//客户地址
                &quot;supply_license_no&quot;: &quot;xk325324534667&quot;,//供货单位许可证号
                &quot;ticket_code&quot;: &quot;500089789789&quot;,//发票号
                &quot;total_cost&quot;: &quot;100000.000000&quot;,//总金额
                &quot;total_cost_dx&quot;: &quot;十万&quot;,//总金额大写
                &quot;handling_person&quot;: &quot;李四&quot;,//送货经手人
                &quot;handling_person_iphone&quot;: &quot;17681130165&quot;,//送货经手人电话
                &quot;delivery_time&quot;: &quot;2022-07-28 09:29:00&quot;,//发货时间 
                &quot;consignee&quot;: &quot;张三&quot;,//收货人
                &quot;consignee_iphone&quot;: &quot;17681130165&quot;,//收货人电话
                &quot;receiving_time&quot;: &quot;2022-07-28 09:29:00&quot;,//收货日期
                &quot;remark&quot;: &quot;好的很1111&quot;,//备注
                &quot;unit_stamp&quot;: &quot;3452534.png&quot;,//单位盖章
                &quot;created_at&quot;: &quot;2022-07-30 15:56:10&quot;,
                &quot;updated_at&quot;: null,
                 &quot;goods_list&quot;: [
                    {
                        &quot;id&quot;: 1,//医疗机械专用送货单id
                        &quot;medical_delivery_id&quot;: 2,//医疗送货单id
                        &quot;main_id&quot;: 4637,
                        &quot;user_id&quot;: 4637,
                        &quot;name&quot;: &quot;葡萄888&quot;,//商品名称
                        &quot;type_name&quot;: &quot;紫8888&quot;,//商品规格
                        &quot;product_unit&quot;: &quot;红富士888&quot;,//商品计数单位
                        &quot;price&quot;: &quot;5.611000&quot;,//单价
                        &quot;num&quot;: 1011,//商品数量
                        &quot;manufacturer&quot;: &quot;掌上网络1&quot;,//生产厂家
                        &quot;batch_number&quot;: &quot;ZS45647547567&quot;,//生产批号
                        &quot;date_in_produced&quot;: &quot;2022-07-30 21:30:30&quot;,//生产日期
                        &quot;effective_date&quot;: &quot;2023-07-30 21:30:30&quot;,//有效时间
                        &quot;storage_condition&quot;: &quot;温度在15度以下&quot;,//存储条件
                        &quot;registration_number&quot;: &quot;zc3252543253656546&quot;,//注册证号
                        &quot;serial_number&quot;: 11,//序号
                        &quot;created_at&quot;: &quot;2022-07-30 15:56:10&quot;,
                        &quot;updated_at&quot;: &quot;2022-08-01 15:02:45&quot;
                    },
                    ......
                ]
            },
           ......
        ],
       ....
        &quot;next_page_url&quot;: null,        
        &quot;total&quot;: 7
    }
}
</code></pre><h2 id="-token-">医疗机械专用送货单信息查询（分享和打印、不用token）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>信息查询</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/medical_delivery_info</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>medical_delivery_id</td>
<td>是</td>
<td>否</td>
<td>医疗机械专用送货单id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 2,//医疗机械专用送货单id
        &quot;main_id&quot;: 4637,
        &quot;user_id&quot;: 4637,
        &quot;customer_name&quot;: &quot;王小玟&quot;,//客户名称
        &quot;customer_address&quot;: &quot;安徽合肥&quot;,//客户地址
        &quot;supply_license_no&quot;: &quot;xk325324534667&quot;,//供货单位许可证号
        &quot;ticket_code&quot;: &quot;500089789789&quot;,//发票号
        &quot;total_cost&quot;: &quot;100000.000000&quot;,//总金额
        &quot;total_cost_dx&quot;: &quot;十万&quot;,//总金额大写
        &quot;handling_person&quot;: &quot;李四&quot;,//送货经手人
        &quot;handling_person_iphone&quot;: &quot;17681130165&quot;,//送货经手人电话
        &quot;delivery_time&quot;: &quot;2022-07-28 09:29:00&quot;,//发货时间 
        &quot;consignee&quot;: &quot;张三&quot;,//收货人
        &quot;consignee_iphone&quot;: &quot;17681130165&quot;,//收货人电话
        &quot;receiving_time&quot;: &quot;2022-07-28 09:29:00&quot;,//收货日期
        &quot;remark&quot;: &quot;好的很1111&quot;,//备注
        &quot;unit_stamp&quot;: &quot;3452534.png&quot;,//单位盖章
        &quot;created_at&quot;: &quot;2022-07-30 15:56:10&quot;,
        &quot;updated_at&quot;: null,
        &quot;goods_list&quot;: [
            {
                &quot;id&quot;: 1,//医疗机械专用送货单id
                &quot;medical_delivery_id&quot;: 2,//医疗送货单id
                &quot;main_id&quot;: 4637,
                &quot;user_id&quot;: 4637,
                &quot;name&quot;: &quot;葡萄888&quot;,//商品名称
                &quot;type_name&quot;: &quot;紫8888&quot;,//商品规格
                &quot;product_unit&quot;: &quot;红富士888&quot;,//商品计数单位
                &quot;price&quot;: &quot;5.611000&quot;,//单价
                &quot;num&quot;: 1011,//商品数量
                &quot;manufacturer&quot;: &quot;掌上网络1&quot;,//生产厂家
                &quot;batch_number&quot;: &quot;ZS45647547567&quot;,//生产批号
                &quot;date_in_produced&quot;: &quot;2022-07-30 21:30:30&quot;,//生产日期
                &quot;effective_date&quot;: &quot;2023-07-30 21:30:30&quot;,//有效时间
                &quot;storage_condition&quot;: &quot;温度在15度以下&quot;,//存储条件
                &quot;registration_number&quot;: &quot;zc3252543253656546&quot;,//注册证号
                &quot;serial_number&quot;: 11,//序号
                &quot;created_at&quot;: &quot;2022-07-30 15:56:10&quot;,
                &quot;updated_at&quot;: &quot;2022-08-01 15:02:45&quot;
            },
            ......
        ]
    }
}
</code></pre><h2 id="-">医疗机械专用发货单添加</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>医疗机械专用发货单添加</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/add_medical_deliver_order</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>customer_name</td>
<td>否</td>
<td>否</td>
<td>客户名称</td>
<td>string</td>
<td>王五</td>
</tr>
<tr>
<td>customer_address</td>
<td>否</td>
<td>否</td>
<td>客户地址</td>
<td>string</td>
<td>安徽蚌埠</td>
</tr>
<tr>
<td>supply_license_no</td>
<td>否</td>
<td>否</td>
<td>供货单位许可证号</td>
<td>string</td>
<td>243235423523</td>
</tr>
<tr>
<td>ticket_code</td>
<td>否</td>
<td>否</td>
<td>发票号</td>
<td>string</td>
<td>3463464356</td>
</tr>
<tr>
<td>total_cost</td>
<td>否</td>
<td>否</td>
<td>总金额</td>
<td>string</td>
<td>100000</td>
</tr>
<tr>
<td>total_cost_dx</td>
<td>否</td>
<td>否</td>
<td>总金额大写</td>
<td>string</td>
<td>十万</td>
</tr>
<tr>
<td>handling_person</td>
<td>否</td>
<td>否</td>
<td>送货经手人</td>
<td>string</td>
<td>李四</td>
</tr>
<tr>
<td>handling_person_iphone</td>
<td>否</td>
<td>否</td>
<td>送货经手人电话</td>
<td>string</td>
<td>17681138888</td>
</tr>
<tr>
<td>delivery_time</td>
<td>否</td>
<td>否</td>
<td>发货时间</td>
<td>string</td>
<td>2022-07-28 09:29:00</td>
</tr>
<tr>
<td>consignee</td>
<td>否</td>
<td>否</td>
<td>收货人</td>
<td>array</td>
<td>小明</td>
</tr>
<tr>
<td>consignee_iphone</td>
<td>否</td>
<td>否</td>
<td>收货人电话</td>
<td>string</td>
<td>17681138888</td>
</tr>
<tr>
<td>receiving_time</td>
<td>否</td>
<td>否</td>
<td>收货日期</td>
<td>string</td>
<td>2022-07-28 09:29:00</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>今天天气真好</td>
</tr>
<tr>
<td>unit_stamp</td>
<td>否</td>
<td>否</td>
<td>单位盖章</td>
<td>string</td>
<td>2142314.png</td>
</tr>
<tr>
<td>goods_info</td>
<td>否</td>
<td>否</td>
<td>商品信息包</td>
<td>array</td>
<td>[{&quot;name&quot;:&quot;葡萄&quot;,&quot;type_name&quot;:&quot;紫&quot;,&quot;product_unit&quot;:&quot;红富士&quot;,&quot;price&quot;:&quot;5.6&quot;,&quot;total_price&quot;:&quot;5.6&quot;,&quot;num&quot;:&quot;10&quot;,&quot;serial_number&quot;:11,&quot;manufacturer&quot;:&quot;掌上网络1&quot;,&quot;batch_number&quot;:&quot;ZS45647547567&quot;,&quot;date_in_produced&quot;:&quot;2022-07-30 21:30:30&quot;,&quot;effective_date&quot;:&quot;2023-07-30 21:30:30&quot;,&quot;storage_condition&quot;:&quot;温度在15度以下&quot;,&quot;registration_number&quot;:&quot;zc3252543253656546&quot;},{&quot;name&quot;:&quot;水梨&quot;,&quot;type_name&quot;:&quot;黄&quot;,&quot;product_unit&quot;:&quot;砀山梨&quot;,&quot;price&quot;:&quot;3.6&quot;,&quot;total_price&quot;:&quot;5.6&quot;,&quot;num&quot;:&quot;8&quot;,&quot;serial_number&quot;:22,&quot;manufacturer&quot;:&quot;掌上网络1&quot;,&quot;batch_number&quot;:&quot;ZS45647547567&quot;,&quot;date_in_produced&quot;:&quot;2022-07-30 21:30:30&quot;,&quot;effective_date&quot;:&quot;2023-07-30 21:30:30&quot;,&quot;storage_condition&quot;:&quot;温度在15度以下&quot;,&quot;registration_number&quot;:&quot;zc3252543253656546&quot;}]</td>
</tr>
<tr>
<td>name</td>
<td>否</td>
<td>否</td>
<td>商品名称（商品信息包里包括）</td>
<td>string</td>
<td>苹果</td>
</tr>
<tr>
<td>type_name</td>
<td>否</td>
<td>否</td>
<td>商品规格 （商品信息包里包括）</td>
<td>string</td>
<td>红</td>
</tr>
<tr>
<td>product_unit</td>
<td>否</td>
<td>否</td>
<td>商品计数单位（商品信息包里包括）</td>
<td>string</td>
<td>件</td>
</tr>
<tr>
<td>price</td>
<td>否</td>
<td>否</td>
<td>单价 （商品信息包里包括）</td>
<td>string</td>
<td>10</td>
</tr>
<tr>
<td>total_price</td>
<td>否</td>
<td>否</td>
<td>总金额 （商品信息包里包括）</td>
<td>string</td>
<td>10</td>
</tr>
<tr>
<td>num</td>
<td>否</td>
<td>否</td>
<td>商品数量 （商品信息包里包括）</td>
<td>string</td>
<td>10</td>
</tr>
<tr>
<td>manufacturer</td>
<td>否</td>
<td>否</td>
<td>生产厂家（商品信息包里包括）</td>
<td>string</td>
<td>红富士</td>
</tr>
<tr>
<td>batch_number</td>
<td>否</td>
<td>否</td>
<td>生产批号（商品信息包里包括）</td>
<td>string</td>
<td>353453425324</td>
</tr>
<tr>
<td>date_in_produced</td>
<td>否</td>
<td>否</td>
<td>生产日期（商品信息包里包括）</td>
<td>string</td>
<td>2022-07-28 09:29:00</td>
</tr>
<tr>
<td>effective_date</td>
<td>否</td>
<td>否</td>
<td>有效时间（商品信息包里包括）</td>
<td>string</td>
<td>2022-07-28 09:29:00</td>
</tr>
<tr>
<td>storage_condition</td>
<td>否</td>
<td>否</td>
<td>存储条件（商品信息包里包括）</td>
<td>string</td>
<td>15度以下</td>
</tr>
<tr>
<td>registration_number</td>
<td>否</td>
<td>否</td>
<td>注册证号（商品信息包里包括）</td>
<td>string</td>
<td>435634634</td>
</tr>
<tr>
<td>serial_number</td>
<td>否</td>
<td>否</td>
<td>序号（商品信息包里包括）</td>
<td>string</td>
<td>242142</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-08-08 17:01`:增加请求参数`total_price`
</code></pre><h2 id="-">医疗机械专用发货单修改</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>医疗机械专用发货单修改</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/upd_medical_deliver_order</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>medical_deliver_id</td>
<td>是</td>
<td>否</td>
<td>医疗机械专用发货单id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>customer_name</td>
<td>否</td>
<td>否</td>
<td>客户名称</td>
<td>string</td>
<td>王五</td>
</tr>
<tr>
<td>customer_address</td>
<td>否</td>
<td>否</td>
<td>客户地址</td>
<td>string</td>
<td>安徽蚌埠</td>
</tr>
<tr>
<td>supply_license_no</td>
<td>否</td>
<td>否</td>
<td>供货单位许可证号</td>
<td>string</td>
<td>243235423523</td>
</tr>
<tr>
<td>ticket_code</td>
<td>否</td>
<td>否</td>
<td>发票号</td>
<td>string</td>
<td>3463464356</td>
</tr>
<tr>
<td>total_cost</td>
<td>否</td>
<td>否</td>
<td>总金额</td>
<td>string</td>
<td>100000</td>
</tr>
<tr>
<td>total_cost_dx</td>
<td>否</td>
<td>否</td>
<td>总金额大写</td>
<td>string</td>
<td>十万</td>
</tr>
<tr>
<td>handling_person</td>
<td>否</td>
<td>否</td>
<td>送货经手人</td>
<td>string</td>
<td>李四</td>
</tr>
<tr>
<td>handling_person_iphone</td>
<td>否</td>
<td>否</td>
<td>送货经手人电话</td>
<td>string</td>
<td>17681138888</td>
</tr>
<tr>
<td>delivery_time</td>
<td>否</td>
<td>否</td>
<td>发货时间</td>
<td>string</td>
<td>2022-07-28 09:29:00</td>
</tr>
<tr>
<td>consignee</td>
<td>否</td>
<td>否</td>
<td>收货人</td>
<td>array</td>
<td>小明</td>
</tr>
<tr>
<td>consignee_iphone</td>
<td>否</td>
<td>否</td>
<td>收货人电话</td>
<td>string</td>
<td>17681138888</td>
</tr>
<tr>
<td>receiving_time</td>
<td>否</td>
<td>否</td>
<td>收货日期</td>
<td>string</td>
<td>2022-07-28 09:29:00</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>今天天气真好</td>
</tr>
<tr>
<td>unit_stamp</td>
<td>否</td>
<td>否</td>
<td>单位盖章</td>
<td>string</td>
<td>2142314.png</td>
</tr>
<tr>
<td>goods_info</td>
<td>否</td>
<td>否</td>
<td>商品信息包(修改时，可以新增商品)</td>
<td>array</td>
<td>[{&quot;goods_id&quot;:1,&quot;name&quot;:&quot;葡萄888&quot;,&quot;type_name&quot;:&quot;紫8888&quot;,&quot;product_unit&quot;:&quot;红富士888&quot;,&quot;price&quot;:&quot;5.611&quot;,&quot;num&quot;:&quot;1011&quot;,&quot;serial_number&quot;:11,&quot;manufacturer&quot;:&quot;掌上网络1&quot;,&quot;batch_number&quot;:&quot;ZS45647547567&quot;,&quot;date_in_produced&quot;:&quot;2022-07-30 21:30:30&quot;,&quot;effective_date&quot;:&quot;2023-07-30 21:30:30&quot;,&quot;storage_condition&quot;:&quot;温度在15度以下&quot;,&quot;registration_number&quot;:&quot;zc3252543253656546&quot;,&quot;total_price&quot;:&quot;666.55&quot;},{&quot;goods_id&quot;:2,&quot;name&quot;:&quot;水梨8888&quot;,&quot;type_name&quot;:&quot;黄888&quot;,&quot;product_unit&quot;:&quot;砀山梨8888&quot;,&quot;price&quot;:&quot;3.6&quot;,&quot;num&quot;:&quot;8&quot;,&quot;serial_number&quot;:22,&quot;manufacturer&quot;:&quot;掌上网络1&quot;,&quot;batch_number&quot;:&quot;ZS45647547567&quot;,&quot;date_in_produced&quot;:&quot;2022-07-30 21:30:30&quot;,&quot;effective_date&quot;:&quot;2023-07-30 21:30:30&quot;,&quot;storage_condition&quot;:&quot;温度在15度以下&quot;,&quot;registration_number&quot;:&quot;zc3252543253656546&quot;,&quot;total_price&quot;:&quot;666.55&quot;},{&quot;name&quot;:&quot;水梨8888&quot;,&quot;type_name&quot;:&quot;黄888&quot;,&quot;product_unit&quot;:&quot;砀山梨888&quot;,&quot;price&quot;:&quot;3.6&quot;,&quot;num&quot;:&quot;8&quot;,&quot;serial_number&quot;:22,&quot;manufacturer&quot;:&quot;掌上网络1&quot;,&quot;batch_number&quot;:&quot;ZS45647547567&quot;,&quot;date_in_produced&quot;:&quot;2022-07-30 21:30:30&quot;,&quot;effective_date&quot;:&quot;2023-07-30 21:30:30&quot;,&quot;storage_condition&quot;:&quot;温度在15度以下&quot;,&quot;registration_number&quot;:&quot;zc3252543253656546&quot;,&quot;total_price&quot;:&quot;666.55&quot;}</td>
</tr>
<tr>
<td>goods_id</td>
<td>是</td>
<td>否</td>
<td>商品id（商品信息包里包括）</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>name</td>
<td>否</td>
<td>否</td>
<td>商品名称（商品信息包里包括）</td>
<td>string</td>
<td>苹果</td>
</tr>
<tr>
<td>type_name</td>
<td>否</td>
<td>否</td>
<td>商品规格 （商品信息包里包括）</td>
<td>string</td>
<td>红</td>
</tr>
<tr>
<td>product_unit</td>
<td>否</td>
<td>否</td>
<td>商品计数单位（商品信息包里包括）</td>
<td>string</td>
<td>件</td>
</tr>
<tr>
<td>price</td>
<td>否</td>
<td>否</td>
<td>单价 （商品信息包里包括）</td>
<td>string</td>
<td>10</td>
</tr>
<tr>
<td>total_price</td>
<td>否</td>
<td>否</td>
<td>总金额 （商品信息包里包括）</td>
<td>string</td>
<td>10</td>
</tr>
<tr>
<td>num</td>
<td>否</td>
<td>否</td>
<td>商品数量 （商品信息包里包括）</td>
<td>string</td>
<td>10</td>
</tr>
<tr>
<td>manufacturer</td>
<td>否</td>
<td>否</td>
<td>生产厂家（商品信息包里包括）</td>
<td>string</td>
<td>红富士</td>
</tr>
<tr>
<td>batch_number</td>
<td>否</td>
<td>否</td>
<td>生产批号（商品信息包里包括）</td>
<td>string</td>
<td>353453425324</td>
</tr>
<tr>
<td>date_in_produced</td>
<td>否</td>
<td>否</td>
<td>生产日期（商品信息包里包括）</td>
<td>string</td>
<td>2022-07-28 09:29:00</td>
</tr>
<tr>
<td>effective_date</td>
<td>否</td>
<td>否</td>
<td>有效时间（商品信息包里包括）</td>
<td>string</td>
<td>2022-07-28 09:29:00</td>
</tr>
<tr>
<td>storage_condition</td>
<td>否</td>
<td>否</td>
<td>存储条件（商品信息包里包括）</td>
<td>string</td>
<td>15度以下</td>
</tr>
<tr>
<td>registration_number</td>
<td>否</td>
<td>否</td>
<td>注册证号（商品信息包里包括）</td>
<td>string</td>
<td>435634634</td>
</tr>
<tr>
<td>serial_number</td>
<td>否</td>
<td>否</td>
<td>序号（商品信息包里包括）</td>
<td>string</td>
<td>242142</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-08-08 17:01`:增加请求参数`total_price`
</code></pre><h2 id="-">医疗机械专用发货单删除（批量删除）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>医疗机械专用发货单删除</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/del_medical_deliver_order</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>ids</td>
<td>是</td>
<td>否</td>
<td>医疗机械专用发货单id (多个逗号分隔)</td>
<td>integer</td>
<td>1,2,3</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">删除医疗机械专用发货单商品（批量删除）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>删除商品</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/del_medical_deliver_goods</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>goods_ids</td>
<td>是</td>
<td>否</td>
<td>商品id (多个逗号分隔)</td>
<td>integer</td>
<td>1,2,3</td>
</tr>
<tr>
<td>medical_deliver_id</td>
<td>是</td>
<td>否</td>
<td>医疗机械专用发货单id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">医疗机械专用发货单信息查询</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>医疗机械专用发货单信息查询</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/medical_deliver_order_info</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>medical_deliver_id</td>
<td>是</td>
<td>否</td>
<td>医疗机械专用发货单id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 2,//医疗机械专用发货单id
        &quot;main_id&quot;: 4637,
        &quot;user_id&quot;: 4637,
        &quot;customer_name&quot;: &quot;王小玟&quot;,//客户名称
        &quot;customer_address&quot;: &quot;安徽合肥&quot;,//客户地址
        &quot;supply_license_no&quot;: &quot;xk325324534667&quot;,//供货单位许可证号
        &quot;ticket_code&quot;: &quot;500089789789&quot;,//发票号
        &quot;total_cost&quot;: &quot;100000.000000&quot;,//总金额
        &quot;total_cost_dx&quot;: &quot;十万&quot;,//总金额大写
        &quot;handling_person&quot;: &quot;李四&quot;,//送货经手人
        &quot;handling_person_iphone&quot;: &quot;17681130165&quot;,//送货经手人电话
        &quot;delivery_time&quot;: &quot;2022-07-28 09:29:00&quot;,//发货时间 
        &quot;consignee&quot;: &quot;张三&quot;,//收货人
        &quot;consignee_iphone&quot;: &quot;17681130165&quot;,//收货人电话
        &quot;receiving_time&quot;: &quot;2022-07-28 09:29:00&quot;,//收货日期
        &quot;remark&quot;: &quot;好的很1111&quot;,//备注
        &quot;unit_stamp&quot;: &quot;3452534.png&quot;,//单位盖章
        &quot;created_at&quot;: &quot;2022-07-30 15:56:10&quot;,
        &quot;updated_at&quot;: null,
        &quot;goods_list&quot;: [
            {
                &quot;id&quot;: 1,//医疗机械专用发货单id
                &quot;medical_deliver_id&quot;: 2,//医疗送货单id
                &quot;main_id&quot;: 4637,
                &quot;user_id&quot;: 4637,
                &quot;name&quot;: &quot;葡萄888&quot;,//商品名称
                &quot;type_name&quot;: &quot;紫8888&quot;,//商品规格
                &quot;product_unit&quot;: &quot;红富士888&quot;,//商品计数单位
                &quot;price&quot;: &quot;5.611000&quot;,//单价
                &quot;num&quot;: 1011,//商品数量
                &quot;manufacturer&quot;: &quot;掌上网络1&quot;,//生产厂家
                &quot;batch_number&quot;: &quot;ZS45647547567&quot;,//生产批号
                &quot;date_in_produced&quot;: &quot;2022-07-30 21:30:30&quot;,//生产日期
                &quot;effective_date&quot;: &quot;2023-07-30 21:30:30&quot;,//有效时间
                &quot;storage_condition&quot;: &quot;温度在15度以下&quot;,//存储条件
                &quot;registration_number&quot;: &quot;zc3252543253656546&quot;,//注册证号
                &quot;serial_number&quot;: 11,//序号
                &quot;created_at&quot;: &quot;2022-07-30 15:56:10&quot;,
                &quot;updated_at&quot;: &quot;2022-08-01 15:02:45&quot;
            },
            ......
        ]
    }
}
</code></pre><h2 id="-">医疗机械专用发货单列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>医疗机械专用发货单列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/get_medical_deliver_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>page_size</td>
<td>是</td>
<td>否</td>
<td>分页个数</td>
<td>integer</td>
<td>15</td>
</tr>
<tr>
<td>current_page</td>
<td>是</td>
<td>否</td>
<td>当前页码</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>否</td>
<td>关键词查询</td>
<td>string</td>
<td>掌上网络</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
            { 
                &quot;id&quot;: 2,//医疗机械专用发货单id
                &quot;main_id&quot;: 4637,
                &quot;user_id&quot;: 4637,
                &quot;customer_name&quot;: &quot;王小玟&quot;,//客户名称
                &quot;customer_address&quot;: &quot;安徽合肥&quot;,//客户地址
                &quot;supply_license_no&quot;: &quot;xk325324534667&quot;,//供货单位许可证号
                &quot;ticket_code&quot;: &quot;500089789789&quot;,//发票号
                &quot;total_cost&quot;: &quot;100000.000000&quot;,//总金额
                &quot;total_cost_dx&quot;: &quot;十万&quot;,//总金额大写
                &quot;handling_person&quot;: &quot;李四&quot;,//送货经手人
                &quot;handling_person_iphone&quot;: &quot;17681130165&quot;,//送货经手人电话
                &quot;delivery_time&quot;: &quot;2022-07-28 09:29:00&quot;,//发货时间 
                &quot;consignee&quot;: &quot;张三&quot;,//收货人
                &quot;consignee_iphone&quot;: &quot;17681130165&quot;,//收货人电话
                &quot;receiving_time&quot;: &quot;2022-07-28 09:29:00&quot;,//收货日期
                &quot;remark&quot;: &quot;好的很1111&quot;,//备注
                &quot;unit_stamp&quot;: &quot;3452534.png&quot;,//单位盖章
                &quot;created_at&quot;: &quot;2022-07-30 15:56:10&quot;,
                &quot;updated_at&quot;: null,
                 &quot;goods_list&quot;: [
                    {
                        &quot;id&quot;: 1,//医疗机械专用发货单id
                        &quot;medical_deliver_id&quot;: 2,//医疗发货单id
                        &quot;main_id&quot;: 4637,
                        &quot;user_id&quot;: 4637,
                        &quot;name&quot;: &quot;葡萄888&quot;,//商品名称
                        &quot;type_name&quot;: &quot;紫8888&quot;,//商品规格
                        &quot;product_unit&quot;: &quot;红富士888&quot;,//商品计数单位
                        &quot;price&quot;: &quot;5.611000&quot;,//单价
                        &quot;num&quot;: 1011,//商品数量
                        &quot;manufacturer&quot;: &quot;掌上网络1&quot;,//生产厂家
                        &quot;batch_number&quot;: &quot;ZS45647547567&quot;,//生产批号
                        &quot;date_in_produced&quot;: &quot;2022-07-30 21:30:30&quot;,//生产日期
                        &quot;effective_date&quot;: &quot;2023-07-30 21:30:30&quot;,//有效时间
                        &quot;storage_condition&quot;: &quot;温度在15度以下&quot;,//存储条件
                        &quot;registration_number&quot;: &quot;zc3252543253656546&quot;,//注册证号
                        &quot;serial_number&quot;: 11,//序号
                        &quot;created_at&quot;: &quot;2022-07-30 15:56:10&quot;,
                        &quot;updated_at&quot;: &quot;2022-08-01 15:02:45&quot;
                    },
                    ......
                ]
            },
           ......
        ],
       ....
        &quot;next_page_url&quot;: null,        
        &quot;total&quot;: 7
    }
}
</code></pre><h2 id="-token-">医疗机械专用发货单信息查询（分享和打印、不用token）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>信息查询</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/medical_deliver_info</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>medical_deliver_id</td>
<td>是</td>
<td>否</td>
<td>医疗机械专用发货单id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 5032 //新增物料id
    }
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-08-05 19:18`:增加请求参数`is_album`,`materiel_unit`,`lower_selling_price`;
变更`type_name`和`materiel_no`由必传为非必传;
(与接口`materiel_type_deit`变动内容相同)
</code></pre><h2 id="-">印章新建</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>印章添加</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/add_seal</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>seal_name</td>
<td>是</td>
<td>否</td>
<td>印章名称</td>
<td>string</td>
<td>公司专用章</td>
</tr>
<tr>
<td>type</td>
<td>是</td>
<td>否</td>
<td>印章类型（1是圆形、2是椭圆形）</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>company_name</td>
<td>是</td>
<td>否</td>
<td>公司名称</td>
<td>string</td>
<td>掌上网络有限公司</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><blockquote>
<p>内容变动</p>
</blockquote>
<pre><code>`2022-08-09 10:27`:增加请求参数`type`;
变更`temp_id`为`type`由非必传为必传;
</code></pre><h2 id="-">印章修改</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>印章修改</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/upd_seal</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>seal_id</td>
<td>是</td>
<td>否</td>
<td>印章id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>seal_name</td>
<td>是</td>
<td>否</td>
<td>印章名称</td>
<td>string</td>
<td>公司专用章</td>
</tr>
<tr>
<td>type</td>
<td>是</td>
<td>否</td>
<td>印章类型（1是圆形、2是椭圆形）</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>company_name</td>
<td>是</td>
<td>否</td>
<td>公司名称</td>
<td>string</td>
<td>掌上网络有限公司</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><blockquote>
<p>内容变动</p>
</blockquote>
<pre><code>`2022-08-09 10:27`:增加请求参数`type`;
变更`temp_id`为`type`由非必传为必传;
</code></pre><h2 id="-">印章删除（批量删除）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>印章删除</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/del_seal</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>ids</td>
<td>是</td>
<td>否</td>
<td>印章id (多个逗号分隔)</td>
<td>integer</td>
<td>1,2,3</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">印章信息查询</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>印章信息查询</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/seal_manage_info</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>seal_id</td>
<td>是</td>
<td>否</td>
<td>印章id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 2,//印章id
        &quot;main_id&quot;: 4637,
        &quot;user_id&quot;: 4637,
        &quot;seal_name&quot;: &quot;公司专用章&quot;,//印章名称
        &quot;type&quot;: &quot;1&quot;,//印章样式，1是圆形、2是椭圆
        &quot;company_name&quot;: &quot;掌上网络有限公司&quot;,//公司名称
        &quot;seal_img&quot;: &quot;/uploads/yz/2022-08-01/62e76faa76cb8.jpg&quot;,//印章图片
        &quot;created_at&quot;: &quot;2022-08-01 14:16:10&quot;,
        &quot;updated_at&quot;: null
    }
}
</code></pre><blockquote>
<p>内容变动</p>
</blockquote>
<pre><code>`2022-08-09 10:27`:变更`temp_id`为`type`;
</code></pre><h2 id="-">印章信息列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>印章信息列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/get_seal_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>page_size</td>
<td>是</td>
<td>否</td>
<td>分页个数</td>
<td>integer</td>
<td>15</td>
</tr>
<tr>
<td>current_page</td>
<td>是</td>
<td>否</td>
<td>当前页码</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
            { 
                &quot;id&quot;: 2,//印章id
                &quot;main_id&quot;: 4637,
                &quot;user_id&quot;: 4637,
                &quot;seal_name&quot;: &quot;公司专用章&quot;,//印章名称
                &quot;type&quot;: &quot;1&quot;,//印章样式，1是圆形、2是椭圆
                &quot;company_name&quot;: &quot;掌上网络有限公司&quot;,//公司名称
                &quot;seal_img&quot;: &quot;/uploads/yz/2022-08-01/62e76faa76cb8.jpg&quot;,//印章图片
                &quot;created_at&quot;: &quot;2022-08-01 14:16:10&quot;,
                &quot;updated_at&quot;: null
            },
           ......
        ],
       ....
        &quot;next_page_url&quot;: null,        
        &quot;total&quot;: 7
    }
}
</code></pre><blockquote>
<p>内容变动</p>
</blockquote>
<pre><code>`2022-08-09 10:27`:变更`temp_id`为`type`;
</code></pre><h2 id="-token-">印章信息查询（分享和打印、不用token）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>印章信息查询</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/get_seal_info</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>receipt_id</td>
<td>是</td>
<td>否</td>
<td>印章id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 2,//印章id
        &quot;main_id&quot;: 4637,
        &quot;user_id&quot;: 4637,
        &quot;seal_name&quot;: &quot;公司专用章&quot;,//印章名称
        &quot;type&quot;: &quot;1&quot;,//印章样式，1是圆形、2是椭圆
        &quot;company_name&quot;: &quot;掌上网络有限公司&quot;,//公司名称
        &quot;seal_img&quot;: &quot;/uploads/yz/2022-08-01/62e76faa76cb8.jpg&quot;,//印章图片
        &quot;created_at&quot;: &quot;2022-08-01 14:16:10&quot;,
        &quot;updated_at&quot;: null
    }
}
</code></pre><blockquote>
<p>内容变动</p>
</blockquote>
<pre><code>`2022-08-09 10:27`:变更`temp_id`为`type`;
</code></pre><h1 id="-zlf-">生成商品画册（zlf）</h1>
<h2 id="-">选择物料商品列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>商品列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/sel_album_goods</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>每页条数</td>
<td>integer</td>
<td>15</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>当前页码</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>materiel_calss_id</td>
<td>否</td>
<td>否</td>
<td>二级分类id，默认为0</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>否</td>
<td>关键词</td>
<td>string</td>
<td>面膜</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,//当前页
        &quot;data&quot;: [
            {
                &quot;id&quot;: 558,  //物料商品id
                &quot;materiel_name&quot;: &quot;艾纯烟酰胺亮肤补水修护套盒&quot;,   //物料名
                &quot;type_name&quot;: &quot;10件套&quot;,    //型号
                &quot;materiel_img&quot;: null,   //物料商品图
                &quot;materiel_no&quot;: &quot;&quot;,  //物料编号
                &quot;materiel_class_id&quot;: 9, //物料商品二级分类id
                &quot;sec_class_name&quot;: &quot;护肤品套装&quot;,  //物料商品二级分类名
                &quot;fir_class_id&quot;: 3,  //物料商品一级分类id
                &quot;fir_class_name&quot;: &quot;美妆用品&quot;,    //物料商品一级分类名
                &quot;remark&quot;: &quot;美妆用品&quot;    //商品备注
                &quot;length&quot;: &quot;0.00&quot;, //长度
                &quot;width&quot;: &quot;0.00&quot;,//宽度
                &quot;height&quot;: &quot;0.00&quot;,//高度
                &quot;weight&quot;: &quot;0.00&quot;,//重量
                &quot;attribute&quot;: &quot;&quot;,//属性
                &quot;cost&quot;: &quot;0.00&quot;,//成本
                &quot;selling_price&quot;:0.22,//售价
                &quot;is_album&quot;:0,//是否在商品画册展示;0:否;1:是;
                &quot;is_exist&quot;:1,//是否生过画册商品：1是，0否
            }
        ],
        ......
        &quot;total&quot;: 1//总数
    }
}
</code></pre><blockquote>
<p>内容变动</p>
</blockquote>
<pre><code>`2022-10-22 17:18`:增加请求参数 is_album`;
</code></pre><h2 id="-">一键生成商品画册</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>生成画册</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/add_material_pic_album</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>select_goods_ids</td>
<td>是</td>
<td>否</td>
<td>选择的物料商品id(多个用英文逗号分隔)</td>
<td>integer</td>
<td>1,2,3</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;:  {
    &quot;album_id&quot;: 1
    }
}
</code></pre><h2 id="-">修改商品画册信息</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>修改商品画册</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/edit_pic_album</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>画册id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>p_a_name</td>
<td>否</td>
<td>否</td>
<td>画册名称</td>
<td>string</td>
<td>掌上网络</td>
</tr>
<tr>
<td>mobile</td>
<td>否</td>
<td>否</td>
<td>联系电话</td>
<td>string</td>
<td>17688888888</td>
</tr>
<tr>
<td>album_cover_img</td>
<td>否</td>
<td>否</td>
<td>画册图片</td>
<td>file</td>
<td>封面图片文件数据包</td>
</tr>
<tr>
<td>background_music</td>
<td>否</td>
<td>否</td>
<td>背景音乐</td>
<td>file</td>
<td>背景音乐文件数据包</td>
</tr>
<tr>
<td>album_logo</td>
<td>否</td>
<td>否</td>
<td>画册logo</td>
<td>file</td>
<td>logo图片文件数据包</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}

</code></pre><blockquote>
<p>内容变动</p>
</blockquote>
<pre><code>`2022-09-27 16:41`:增加请求参数 album_logo`;
</code></pre><h2 id="-">删除商品画册信息</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>删除商品画册</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/del_pic_album</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>album_ids</td>
<td>是</td>
<td>否</td>
<td>画册id(多个用逗号分隔)</td>
<td>integer</td>
<td>1,2,3</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">修改画册里商品信息</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>修改商品信息</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/edit_pic_album_goods</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>商品id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>album_id</td>
<td>是</td>
<td>否</td>
<td>画册id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>materiel_name</td>
<td>否</td>
<td>否</td>
<td>商品名称</td>
<td>string</td>
<td>掌上网络</td>
</tr>
<tr>
<td>type_name</td>
<td>否</td>
<td>否</td>
<td>商品型号</td>
<td>file</td>
<td>GT456345634</td>
</tr>
<tr>
<td>materiel_img</td>
<td>否</td>
<td>否</td>
<td>商品图片</td>
<td>file</td>
<td>file数据包</td>
</tr>
<tr>
<td>materiel_unit</td>
<td>否</td>
<td>否</td>
<td>商品单位</td>
<td>string</td>
<td>件</td>
</tr>
<tr>
<td>length</td>
<td>否</td>
<td>否</td>
<td>长(cm)</td>
<td>string</td>
<td>22</td>
</tr>
<tr>
<td>width</td>
<td>否</td>
<td>否</td>
<td>宽(cm)</td>
<td>string</td>
<td>22</td>
</tr>
<tr>
<td>height</td>
<td>否</td>
<td>否</td>
<td>高(cm)</td>
<td>string</td>
<td>22</td>
</tr>
<tr>
<td>weight</td>
<td>否</td>
<td>否</td>
<td>重量(kg)</td>
<td>string</td>
<td>22</td>
</tr>
<tr>
<td>attribute</td>
<td>否</td>
<td>否</td>
<td>属性</td>
<td>array</td>
<td>[{&quot;name&quot;:&quot;11&quot;,&quot;value&quot;:&quot;111&quot;}]</td>
</tr>
<tr>
<td>cost</td>
<td>否</td>
<td>否</td>
<td>成本</td>
<td>string</td>
<td>888.88</td>
</tr>
<tr>
<td>last_cost</td>
<td>否</td>
<td>否</td>
<td>上一次成本(采购撤销回滚cost用)</td>
<td>string</td>
<td>888.88</td>
</tr>
<tr>
<td>selling_price</td>
<td>否</td>
<td>否</td>
<td>销售价格</td>
<td>string</td>
<td>888.88</td>
</tr>
<tr>
<td>lower_selling_price</td>
<td>否</td>
<td>否</td>
<td>最低销售价格</td>
<td>string</td>
<td>888.88</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>画册图片</td>
<td>string</td>
<td>备注</td>
</tr>
<tr>
<td>materiel_class_id</td>
<td>否</td>
<td>否</td>
<td>物料所属二级类型</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">删除画册里商品</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>删除商品画册</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/del_pic_album_goods</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>album_id</td>
<td>是</td>
<td>否</td>
<td>画册id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>ids</td>
<td>是</td>
<td>否</td>
<td>商品id（多个用逗号分隔）</td>
<td>integer</td>
<td>1,2,3</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}

</code></pre><h2 id="-">删除画册商品分类</h2>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>删除画册商品分类</td>
<td>http</td>
<td>post</td>
<td>api/del_hc_class</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>type</td>
<td>是</td>
<td>否</td>
<td>物料分类类型(0:一级分类;1:二级分类;)</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>物料分类名称</td>
<td>sting</td>
<td>71</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注</p>
<pre><code>1、一级分类下若存在未删除的二级分类，需先删除其所有二级分类后方可操作
2、二级分类下若存在未删除的物料类型，需先删除其所有物料类型后方可操作
</code></pre><p>数据返回</p>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre></blockquote>
<h2 id="-">修改画册商品分类</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>编辑查询</td>
<td>http</td>
<td>post</td>
<td>api/edit_hc_class</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>商品分类id</td>
<td>integer</td>
<td>179</td>
</tr>
<tr>
<td>type</td>
<td>是</td>
<td>否</td>
<td>商品分类类型(0:一级分类;1:二级分类;)</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>class_name</td>
<td>是</td>
<td>否</td>
<td>商品分类名称</td>
<td>sting</td>
<td>保温箱</td>
</tr>
<tr>
<td>class_no</td>
<td>是</td>
<td>否</td>
<td>商品分类编号(不能低于或超出8位字符长度)</td>
<td>sting</td>
<td>7udIZcaQ</td>
</tr>
<tr>
<td>parent_id</td>
<td>是</td>
<td>否</td>
<td>上级商品分类id(所修改的分类为一级分类时，默认为0)</td>
<td>integer</td>
<td>179</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">商品画册列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>生成画册</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/material_pic_album_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>page_size</td>
<td>是</td>
<td>否</td>
<td>每页条数</td>
<td>integer</td>
<td>15</td>
</tr>
<tr>
<td>current_page</td>
<td>是</td>
<td>否</td>
<td>当前页码</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>album_id</td>
<td>是</td>
<td>否</td>
<td>商品画册id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>materiel_class_id</td>
<td>否</td>
<td>否</td>
<td>二级分类id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>parent_class_id</td>
<td>否</td>
<td>否</td>
<td>一级分类id（首页点击标签传递）</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;album_data&quot;: {
            &quot;id&quot;: 1,//画册id
            &quot;p_a_name&quot;: &quot;掌上网络有限公司&quot;,//画册名称
            &quot;album_cover_img&quot;: &quot;&quot;,//画册图片
            &quot;background_music&quot;: &quot;&quot;,//背景音乐
            &quot;mobile&quot;: &quot;&quot;,//联系电脑
            &quot;flag&quot;: &quot;goods&quot;,//画册标签
            &quot;album_logo&quot;:&quot;&quot;商品画册logo
        },
        &quot;list&quot;: {
            &quot;current_page&quot;: 1,
            &quot;data&quot;: [
                {
                    &quot;id&quot;: 127,//物料分类一级id
                    &quot;class_name&quot;: &quot;防护用品&quot;,//物料分类一级名称
                    &quot;class_no&quot;: &quot;edePWhUW&quot;,//一级分类编号
                    &quot;next_class&quot;: [
                        {                            
                            &quot;id&quot;: 139,//物料分类二级id
                            &quot;class_name&quot;: &quot;应急服装&quot;//物料分类二级名称
                            &quot;parent_id&quot;: 127,//上一级id
                            &quot;class_no&quot;: &quot;12346579&quot;//二级分类编号
                            &quot;next_hc_type&quot;: [
                                {
                                    &quot;id&quot;: 558,  //物料商品id
                                    &quot;album_id&quot;: 1,//商品画册id
                                    &quot;materiel_name&quot;: &quot;艾纯烟酰胺亮肤补水修护套盒&quot;,   //物料名
                                    &quot;type_name&quot;: &quot;10件套&quot;,    //型号
                                    &quot;materiel_img&quot;: null,   //物料商品图
                                    &quot;materiel_no&quot;: &quot;&quot;,  //物料编号
                                    &quot;materiel_class_id&quot;: 9, //物料商品二级分类id
                                    &quot;materiel_unit&quot;: &quot;&quot;,//商品单位
                                    &quot;sec_class_name&quot;: &quot;护肤品套装&quot;,  //物料商品二级分类名
                                    &quot;fir_class_id&quot;: 3,  //物料商品一级分类id
                                    &quot;fir_class_name&quot;: &quot;美妆用品&quot;,    //物料商品一级分类名
                                    &quot;remark&quot;: &quot;美妆用品&quot;    //商品备注
                                    &quot;length&quot;: &quot;0.00&quot;, //长度
                                    &quot;width&quot;: &quot;0.00&quot;,//宽度
                                    &quot;height&quot;: &quot;0.00&quot;,//高度
                                    &quot;weight&quot;: &quot;0.00&quot;,//重量              
                                    &quot;attribute&quot;: &quot;[{\&quot;name\&quot;:\&quot;11\&quot;,\&quot;value\&quot;:\&quot;111\&quot;}]&quot;,//属性
                                    &quot;cost&quot;: &quot;68.900000&quot;,//成本
                                    &quot;last_cost&quot;: &quot;0.000000&quot;,//上一次成本(采购撤销回滚cost用)
                                    &quot;selling_price&quot;: &quot;88.999000&quot;,//销售价格
                                    &quot;lower_selling_price&quot;: &quot;0.000000&quot;,//最低销售价格
                                    &quot;is_album&quot;: 1,//是否在画册中展示:1是，0否
                                    &quot;main_id&quot;: 4637,//主账号                                    
                                    &quot;delete_flag&quot;: 0,//是否删除;0:否;1:是;
                                    &quot;created_at&quot;: &quot;2022-08-08 16:16:46&quot;,//创建时间
                                },
                                ......
                            ]
                        },
                        ......
                    ]
                }
            ],
            ......
            &quot;next_page_url&quot;: null,
            ......
            &quot;total&quot;: 1
        }
    }
}

</code></pre><blockquote>
<p>内容变动</p>
</blockquote>
<pre><code>`2022-09-27 16:41`:增加返回参数 album_logo`;
</code></pre><h2 id="-token-">商品画册列表(分享不带token)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>生成画册</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/get_goods_album_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>page_size</td>
<td>是</td>
<td>否</td>
<td>每页条数</td>
<td>integer</td>
<td>15</td>
</tr>
<tr>
<td>current_page</td>
<td>是</td>
<td>否</td>
<td>当前页码</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>album_id</td>
<td>是</td>
<td>否</td>
<td>商品画册id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>materiel_class_id</td>
<td>否</td>
<td>否</td>
<td>二级分类id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>parent_class_id</td>
<td>否</td>
<td>否</td>
<td>一级分类id（首页点击标签传递）</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;album_data&quot;: {
            &quot;id&quot;: 1,//画册id
            &quot;p_a_name&quot;: &quot;掌上网络有限公司&quot;,//画册名称
            &quot;album_cover_img&quot;: &quot;&quot;,//画册图片
            &quot;background_music&quot;: &quot;&quot;,//画册图片
            &quot;mobile&quot;: &quot;&quot;,//画册图片
            &quot;flag&quot;: &quot;goods&quot;,//画册标签
            &quot;album_logo&quot;:&quot;&quot;商品画册logo
        },
        &quot;list&quot;: {
            &quot;current_page&quot;: 1,
            &quot;data&quot;: [
                {
                    &quot;id&quot;: 127,//物料分类一级id
                    &quot;class_name&quot;: &quot;防护用品&quot;,//物料分类一级名称
                    &quot;class_no&quot;: &quot;edePWhUW&quot;,//一级分类编号
                    &quot;next_class&quot;: [
                        {                            
                            &quot;id&quot;: 139,//物料分类二级id
                            &quot;class_name&quot;: &quot;应急服装&quot;//物料分类二级名称
                            &quot;parent_id&quot;: 127,//上一级id
                            &quot;class_no&quot;: &quot;12346579&quot;//二级分类编号
                            &quot;next_hc_type&quot;: [
                                {
                                    &quot;id&quot;: 558,  //物料商品id
                                    &quot;album_id&quot;: 1,//商品画册id
                                    &quot;materiel_name&quot;: &quot;艾纯烟酰胺亮肤补水修护套盒&quot;,   //物料名
                                    &quot;type_name&quot;: &quot;10件套&quot;,    //型号
                                    &quot;materiel_img&quot;: null,   //物料商品图
                                    &quot;materiel_no&quot;: &quot;&quot;,  //物料编号
                                    &quot;materiel_class_id&quot;: 9, //物料商品二级分类id
                                    &quot;materiel_unit&quot;: &quot;&quot;,//商品单位
                                    &quot;sec_class_name&quot;: &quot;护肤品套装&quot;,  //物料商品二级分类名
                                    &quot;fir_class_id&quot;: 3,  //物料商品一级分类id
                                    &quot;fir_class_name&quot;: &quot;美妆用品&quot;,    //物料商品一级分类名
                                    &quot;remark&quot;: &quot;美妆用品&quot;    //商品备注
                                    &quot;length&quot;: &quot;0.00&quot;, //长度
                                    &quot;width&quot;: &quot;0.00&quot;,//宽度
                                    &quot;height&quot;: &quot;0.00&quot;,//高度
                                    &quot;weight&quot;: &quot;0.00&quot;,//重量              
                                    &quot;attribute&quot;: &quot;[{\&quot;name\&quot;:\&quot;11\&quot;,\&quot;value\&quot;:\&quot;111\&quot;}]&quot;,//属性
                                    &quot;cost&quot;: &quot;68.900000&quot;,//成本
                                    &quot;last_cost&quot;: &quot;0.000000&quot;,//上一次成本(采购撤销回滚cost用)
                                    &quot;selling_price&quot;: &quot;88.999000&quot;,//销售价格
                                    &quot;lower_selling_price&quot;: &quot;0.000000&quot;,//最低销售价格
                                    &quot;is_album&quot;: 1,//是否在画册中展示:1是，0否
                                    &quot;main_id&quot;: 4637,//主账号                                    
                                    &quot;delete_flag&quot;: 0,//是否删除;0:否;1:是;
                                    &quot;created_at&quot;: &quot;2022-08-08 16:16:46&quot;,//创建时间
                                },
                                ......
                            ]
                        },
                        ......
                    ]
                }
            ],
            ......
            &quot;next_page_url&quot;: null,
            ......
            &quot;total&quot;: 1
        }
    }
}

</code></pre><blockquote>
<p>内容变动</p>
</blockquote>
<pre><code>`2022-09-27 16:41`:增加返回参数 album_logo`;
</code></pre><h1 id="-">套餐</h1>
<h2 id="-mr-sun-">套餐列表(Mr Sun)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>编辑查询</td>
<td>http</td>
<td>post</td>
<td>/v3.1/api/package_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>每页条数</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>当前页码</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>是</td>
<td>关键词，支持对<code>分类名、套餐名、物料名称、物料型号和物料以及分类型号</code>检索</td>
<td>string</td>
<td>测试</td>
</tr>
<tr>
<td>storage_id</td>
<td>否</td>
<td>否</td>
<td>仓库id</td>
<td>integer</td>
<td>123456</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
            {
                &quot;id&quot;: 189,
                &quot;package_name&quot;: &quot;黑桃套餐二&quot;,
                &#39;status&#39;: 1, //是否可操作;0:否;1:是;
                &quot;has_many_content&quot;: []
            },
            {
                &quot;id&quot;: 188,//套餐id
                &quot;package_name&quot;: &quot;黑桃套餐一&quot;,//套餐id
                &quot;has_many_content&quot;: [
                    {
                        &quot;id&quot;: 4,//套餐内容id
                        &quot;materiel_first_class_id&quot;: 3,//套餐内物料一级分类id
                        &quot;materiel_first_class_name&quot;: &quot;美妆用品&quot;,//套餐内物料一级分类名
                        &quot;materiel_first_class_no&quot;: &quot;&quot;,//套餐内物料一级分类编号
                        &quot;materiel_class_id&quot;: 7,//套餐内物料二级分类id
                        &quot;materiel_class_name&quot;: &quot;面膜&quot;,//套餐内物料二级分类名
                        &quot;materiel_class_no&quot;: &quot;&quot;,//套餐内物料二级分类编号
                        &quot;materiel_name&quot;: &quot;微精华舒缓修护面膜&quot;,//物料名
                        &quot;type_name&quot;: &quot;修护&quot;,//型号
                        &quot;materiel_img&quot;: &quot;/uploads/2022/08/02/CzpnwutM6Lkb7ezc0q2gHn3rdNyhq301ZJQaSpzk.jpg&quot;,//图片
                        &quot;materiel_thumbnail_img&quot;: &quot;/uploads/2022/08/02/CzpnwutM6Lkb7ezc0q2gHn3rdNyhq301ZJQaSpzk.jpg&quot;,//缩略图片
                        &quot;materiel_no&quot;: &quot;&quot;,//物料编号
                        &quot;storage_id&quot;: 48,//仓库id
                        &quot;storage_name&quot;: &quot;B1-9栋&quot;,//仓库名
                        &quot;storage_address&quot;: &quot;B1-9栋&quot;,//仓库地址
                        &quot;storage_manage_id&quot;: 529,//库存id
                        &quot;package_id&quot;: 188,//套餐id
                        &quot;num&quot;: 101,//套餐内物料数量
                        &#39;in_storage_num&#39;: 110,//库存数
                        &quot;delete_flag&quot;: 0,//是否删除;0:否;1:是;
                        &quot;shelf_id&quot;: 1613, //货架ID
                        &quot;location_id&quot;: 1614,//库位ID
                        &quot;shelf_name&quot;: &quot;测试货架1&quot;, //货架名称
                        &quot;location_name&quot;: &quot;测试库位2&quot; //库位名称
                        &quot;cost&quot;: &quot;12.000001&quot;,//成本
                        &quot;selling_price&quot;: &quot;20.01&quot;//销售价
                    }
                ]
            }
        ],
        &quot;total&quot;: 2 //总条数
    }
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-09-06 16:57`:增加`selling_price`返回
`2022-09-06 14:54`:增加`cost`返回
`2022-09-03 17:14`:增加`materiel_thumbnail_img`返回
`2022-08-29 17:30`:增加`materiel_img`返回
`2022-08-25 16:40`:增加`shelf_id`,`location_id`,`shelf_name`,`location_name`返回 
`2022-11-4 18:02`:增加`storage_id`请求参数
</code></pre></blockquote>
<h2 id="-mr-sun-">套餐内容列表(Mr Sun)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>套餐内容列表</td>
<td>http</td>
<td>post</td>
<td>api/content_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>每页条数</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>当前页码</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>套餐id</td>
<td>string</td>
<td>157</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
            {
                &quot;id&quot;: 1, //套餐内容id
                &quot;materiel_first_class_name&quot;: &quot;美妆用品&quot;,    //物料一级分类名
                &quot;materiel_first_class_no&quot;: &quot;&quot;,  //物料一级分类编号
                &quot;materiel_class_name&quot;: &quot;护肤品套装&quot;, //物料二级分类名
                &quot;materiel_class_no&quot;: &quot;&quot;,    //物料二级分类编号
                &quot;materiel_name&quot;: &quot;艾纯烟酰胺亮肤补水修护套盒&quot;,   //物料名
                &quot;type_name&quot;: &quot;10件套&quot;,    //型号
                &quot;materiel_img&quot;: &quot;/uploads/2022/08/02/CzpnwutM6Lkb7ezc0q2gHn3rdNyhq301ZJQaSpzk.jpg&quot;,//图片
                &quot;materiel_thumbnail_img&quot;: &quot;/uploads/2022/08/02/CzpnwutM6Lkb7ezc0q2gHn3rdNyhq301ZJQaSpzk.jpg&quot;,//缩略图片
                &quot;materiel_no&quot;: &quot;&quot;,  //物料编号
                &quot;storage_id&quot;: 48,   //物料当前所在仓库id
                &quot;storage_name&quot;: &quot;B1-9栋&quot;,    //仓库名
                &quot;storage_address&quot;: &quot;B1-9栋&quot;, //仓库地址
                &quot;storage_manage_id&quot;: 535,   //在库id
                &quot;package_id&quot;: 157,  //套餐id
                &quot;num&quot;: 101, // 套餐内物料数量
                &quot;in_storage_num&quot;: 128   //在库数量
                &quot;delete_flag&quot;:1//是否删除;0:否;1:是;
            },
            ......
        ]
        &quot;total&quot;: 6  //
    }
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-09-03 17:14`:增加`materiel_thumbnail_img`， `materiel_img`返回
</code></pre></blockquote>
<h1 id="-zlf-">共享设置(zlf)</h1>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>共享设置</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/share_setting</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>type</td>
<td>是</td>
<td>否</td>
<td>类型;</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>参数<code>type</code>说明</p>
</blockquote>
<table>
<thead>
<tr>
<th>值</th>
<th>说明  </th>
</tr>
</thead>
<tbody>
<tr>
<td>14</td>
<td>是否使用序列号   </td>
</tr>
<tr>
<td>13</td>
<td>将客户作为供应商使用   </td>
</tr>
<tr>
<td>12</td>
<td>共享仓库 </td>
</tr>
<tr>
<td>11</td>
<td>共享操作记录 </td>
</tr>
<tr>
<td>10</td>
<td>共享销售</td>
</tr>
<tr>
<td>9</td>
<td>共享采购</td>
</tr>
<tr>
<td>8</td>
<td>共享退货 </td>
</tr>
<tr>
<td>7</td>
<td>是否共享客户 </td>
</tr>
<tr>
<td>6</td>
<td>是否共享供应商 </td>
</tr>
<tr>
<td>5</td>
<td>共享报损</td>
</tr>
<tr>
<td>4</td>
<td>共享报溢 </td>
</tr>
<tr>
<td>3</td>
<td>共享快递价格计算</td>
</tr>
<tr>
<td>2</td>
<td>共享空白单据 </td>
</tr>
<tr>
<td>1</td>
<td>货架库位使用开关</td>
</tr>
<tr>
<td>0</td>
<td>开启快递信息共享 </td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: 1    //开启或关闭后的当前状态值
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-08-05 20:13`:增加返回参数`type` `14 是否使用序列号   `
</code></pre><h1 id="-zlf-">共享列表(zlf)</h1>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>共享设置</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/share_setting_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td></td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;is_use_serial&quot;: 0,//是否使用序列号;0:否;1:是
        &quot;is_set_as_supplier&quot;: 0,//是否将客户作为供应商使用;0:否;1:是
        &quot;is_share_store&quot;: 0,//共享仓库：1是 0否
        &quot;is_share_operating_record&quot;: 1,//共享操作记录：1是 0否
        &quot;is_share_sell&quot;: 0,//共享销售：1是 0否
        &quot;is_share_purchase&quot;: 1,//共享采购：1是 0否
        &quot;is_share_sales_return&quot;: 0,//共享退货：1是 0否
        &quot;is_share_customer&quot;: 0,//是否共享客户;0:否;1:是
        &quot;is_share_supplier&quot;: 0,//是否共享供应商;0:否;1:是
        &quot;is_share_breakage&quot;: 0,//共享报损：1是 0否
        &quot;is_share_overflow&quot;: 0,//共享报溢：1是 0否
        &quot;is_share_express_price_calculation&quot;: 0,//共享快递价格计算：1是 0否        
        &quot;is_share_billhead&quot;: 0,//共享空白单据：1是 0否
        &quot;is_use_shelf&quot;: 1//货架库位使用开关1 使用 0关闭
        &quot;is_share_express&quot;: 0,//是否共享快递信息;0:否;1:是
    }
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-08-05 20:13`:增加返回参数`is_use_serial`
</code></pre><h1 id="-zlf-">客户采购商品统计(zlf)</h1>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>采购商品统计</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/statistics_purchased_goods</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>每页显示条数</td>
<td>integer</td>
<td>15</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>页码</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>customer_id</td>
<td>是</td>
<td>否</td>
<td>供应商或客户id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>start_time</td>
<td>否</td>
<td>否</td>
<td>开始时间</td>
<td>date</td>
<td>2021-02-11</td>
</tr>
<tr>
<td>end_time</td>
<td>否</td>
<td>否</td>
<td>结束时间</td>
<td>date</td>
<td>12021-02-11</td>
</tr>
<tr>
<td>number_sort</td>
<td>否</td>
<td>否</td>
<td>数量排序(desc或asc)</td>
<td>string</td>
<td>desc</td>
</tr>
<tr>
<td>price_sort</td>
<td>否</td>
<td>否</td>
<td>价格排序(desc或asc)</td>
<td>string</td>
<td>desc</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>否</td>
<td>关键词</td>
<td>string</td>
<td>掌上网络</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;total_amount&quot;: &quot;679&quot;,  //总数
        &quot;total_price&quot;: &quot;15520.00&quot;,  //总金额
        &quot;materiel_content_info&quot;: {
            &quot;current_page&quot;: 1,
            &quot;data&quot;: [
                {
                    &quot;type_id&quot;: 77,  //商品id
                    &quot;materiel_name&quot;: &quot;潮牌&quot;, //商品名
                    &quot;type_name&quot;: &quot;b&quot;,  //商品规格名                    
                    &quot;materiel_img&quot;: &quot;&quot;, //商品图
                    &quot;total_unit_price&quot;: &quot;12750.00&quot;,//成本价
                    &quot;num&quot;: &quot;1&quot;  //单个商品总数
                }
            ],
            &quot;total&quot;: 9
        }
    }
}
</code></pre><h1 id="-zlf-">客户销售商品统计(zlf)</h1>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>销售商品统计</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/statistics_goods_sold</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>每页显示条数</td>
<td>integer</td>
<td>15</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>页码</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>customer_id</td>
<td>是</td>
<td>否</td>
<td>供应商或客户id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>start_time</td>
<td>否</td>
<td>否</td>
<td>开始时间</td>
<td>date</td>
<td>2021-02-11</td>
</tr>
<tr>
<td>end_time</td>
<td>否</td>
<td>否</td>
<td>结束时间</td>
<td>date</td>
<td>12021-02-11</td>
</tr>
<tr>
<td>number_sort</td>
<td>否</td>
<td>否</td>
<td>销量排序(desc或asc)</td>
<td>string</td>
<td>desc</td>
</tr>
<tr>
<td>price_sort</td>
<td>否</td>
<td>否</td>
<td>价格排序(desc或asc)</td>
<td>string</td>
<td>desc</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>否</td>
<td>关键词</td>
<td>string</td>
<td>掌上网络</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {    
        &quot;sell_final_money&quot;: &quot;1020.000000&quot;, //总售价        
        &quot;sell_goods_list&quot;: {
            &quot;current_page&quot;: 1,
            &quot;data&quot;: [
                {

                    &quot;materiel_name&quot;: &quot;测试1&quot;,//商品名
                    &quot;type_name&quot;: &quot;型号1&quot;,//商品规格
                    &quot;materiel_img&quot;: &quot;&quot;,//商品图
                    &quot;total_num&quot;: &quot;3.000000&quot;,//单商品总数
                    &quot;total_cost&quot;: &quot;60.000000000000&quot;//单商品总成本
                }
            ],
            &quot;total&quot;: 6  //
        }
    }
}
</code></pre><h1 id="-zlf-">设置存储空间选项（zlf）</h1>
<h2 id="-">添加存储空间选项</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>添加存储空间选项</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/add_storage_space_choose</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>set_space</td>
<td>是</td>
<td>否</td>
<td>存储空间大小（单位：M）</td>
<td>integer</td>
<td>100</td>
</tr>
<tr>
<td>price</td>
<td>是</td>
<td>否</td>
<td>价格</td>
<td>sting</td>
<td>50</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">修改存储空间选项</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>修改存储空间选项</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/edit_storage_space_choose</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>存储空间选项id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>set_space</td>
<td>是</td>
<td>否</td>
<td>存储空间大小（单位：M）</td>
<td>integer</td>
<td>100</td>
</tr>
<tr>
<td>price</td>
<td>是</td>
<td>否</td>
<td>价格</td>
<td>sting</td>
<td>50</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">删除存储空间选项</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>删除存储空间选项</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/del_storage_space_choose</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>ids</td>
<td>是</td>
<td>否</td>
<td>存储空间选项id（多个用英文逗号分隔）</td>
<td>integer</td>
<td>1,2,3</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">查询存储空间选项列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/storage_space_choose_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td></td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: [
        {
            &quot;id&quot;: 1,
            &quot;set_space&quot;: 100,//存储空间
            &quot;price&quot;: &quot;100.00&quot;,//对应价格
            &quot;created_at&quot;: &quot;2022-08-26 15:42:46&quot;,
            &quot;updated_at&quot;: null
        },
        {
            &quot;id&quot;: 2,
            &quot;set_space&quot;: 200,
            &quot;price&quot;: &quot;200.00&quot;,
            &quot;created_at&quot;: &quot;2022-08-26 15:42:51&quot;,
            &quot;updated_at&quot;: null
        },
        {
            &quot;id&quot;: 3,
            &quot;set_space&quot;: 300,
            &quot;price&quot;: &quot;300.00&quot;,
            &quot;created_at&quot;: &quot;2022-08-26 15:42:59&quot;,
            &quot;updated_at&quot;: null
        }
    ]
}
</code></pre><h2 id="-">查询存储空间选项信息</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>查询信息</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/storage_space_choose_info</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>存储空间选项id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 1,
        &quot;set_space&quot;: 100,//存储空间
        &quot;price&quot;: &quot;100.00&quot;,//对应价格
        &quot;created_at&quot;: &quot;2022-08-26 15:42:46&quot;,
        &quot;updated_at&quot;: null
    }
}
</code></pre><h1 id="-zlf-">盘点管理 （zlf）</h1>
<h2 id="-">仓库列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>查询信息</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/get_storage_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td></td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: [
        {
            &quot;id&quot;: 1877,//仓库id
            &quot;storage_name&quot;: &quot;总仓&quot;//仓库名称
        },
        ......
    ]
}
</code></pre><h2 id="-">指定仓库商品列表（商品选择也用此接口）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>查询信息</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/get_storage_goods_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>每页显示条数</td>
<td>integer</td>
<td>15</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>页码</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>storage_id</td>
<td>是</td>
<td>否</td>
<td>仓库id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
            {
                &quot;id&quot;: 135,//库存id
                &quot;type_id&quot;: 35171,//物料id
                &quot;materiel_name&quot;: &quot;aaaaaaa&quot;,//物料商品名称
                &quot;materiel_img&quot;: &quot;/uploads/2022/08/25/407e5ca1bfec3ea89969ad4b212d0b7d.jpeg&quot;,//物料商品图片
                &quot;shelf_name&quot;: &quot;默认货架&quot;,//货架名称
                &quot;location_name&quot;: &quot;默认库位&quot;,//货架仓位
                &quot;type_name&quot;: &quot;aaaaaaa&quot;,//型号
                &quot;materiel_no&quot;: &quot;DUmawUK5&quot;,//编号
                &quot;total_amount&quot;: &quot;933333.332400&quot;//单个总数量
            },
            ......
        ],
        ......
        &quot;next_page_url&quot;: null,
        ......
        &quot;total&quot;: 4
    }
}
</code></pre><h2 id="-">通过批次号查询仓库商品信息（扫码）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>查询信息</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/get_read_batch_no</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>batch_no</td>
<td>是</td>
<td>否</td>
<td>批次号（或 序列号）</td>
<td>integer</td>
<td>smyc2022082516171255700</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {

        &quot;id&quot;: 135,//库存id
        &quot;type_id&quot;: 35171,//物料id
        &quot;materiel_name&quot;: &quot;aaaaaaa&quot;,//物料商品名称
        &quot;materiel_img&quot;: &quot;/uploads/2022/08/25/407e5ca1bfec3ea89969ad4b212d0b7d.jpeg&quot;,//物料商品图片
        &quot;shelf_name&quot;: &quot;默认货架&quot;,//货架名称
        &quot;location_name&quot;: &quot;默认库位&quot;,//货架仓位
        &quot;type_name&quot;: &quot;aaaaaaa&quot;,//型号
        &quot;materiel_no&quot;: &quot;DUmawUK5&quot;,//编号
        &quot;total_amount&quot;: &quot;933333.332400&quot;//单个总数量            
    }
}
</code></pre><h2 id="-">添加整仓盘点（适用添加指定仓库中商品）</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>添加整仓盘点</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/add_check_storage_data</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>storage_id</td>
<td>是</td>
<td>否</td>
<td>仓库id</td>
<td>integer</td>
<td>100</td>
</tr>
<tr>
<td>sg_type</td>
<td>是</td>
<td>否</td>
<td>盘点类型（1整仓、2商品）</td>
<td>sting</td>
<td>1</td>
</tr>
<tr>
<td>is_cover</td>
<td>否</td>
<td>否</td>
<td>是否覆盖库存（1是）</td>
<td>sting</td>
<td>1</td>
</tr>
<tr>
<td>goods_info</td>
<td>是</td>
<td>否</td>
<td>要盘点的仓库商品数据包</td>
<td>array</td>
<td>[{&quot;storage_manage_id&quot;:138,&quot;type_id&quot;:35173,&quot;yk_flag&quot;:1,&quot;check_num&quot;:1800,&quot;yk_num&quot;:100},{&quot;storage_manage_id&quot;:136,&quot;type_id&quot;:35172,&quot;yk_flag&quot;:2,&quot;check_num&quot;:60,&quot;yk_num&quot;:20}]</td>
</tr>
<tr>
<td>storage_manage_id</td>
<td>是</td>
<td>否</td>
<td>库存id （数据包包括）</td>
<td>integer</td>
<td>138</td>
</tr>
<tr>
<td>type_id</td>
<td>是</td>
<td>否</td>
<td>物料id（数据包包括）</td>
<td>integer</td>
<td>35173</td>
</tr>
<tr>
<td>yk_flag</td>
<td>是</td>
<td>否</td>
<td>盈亏标示：（1盈、2亏）（数据包包括）</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>check_num</td>
<td>是</td>
<td>否</td>
<td>盘点数（数据包包括）</td>
<td>integer</td>
<td>800</td>
</tr>
<tr>
<td>yk_num</td>
<td>是</td>
<td>否</td>
<td>盈亏数量 （数据包包括）</td>
<td>integer</td>
<td>100</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h2 id="-">盘点列表(已盘点)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>查询信息</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/get_check_storage_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>每页显示条数</td>
<td>integer</td>
<td>15</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>页码</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>否</td>
<td>关键词（盘点人账号）</td>
<td>integer</td>
<td>小强</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
                {
                &quot;id&quot;: 3,//已盘点id
                &quot;check_no&quot;: &quot;46451662516362848&quot;,//盘点编号
                &quot;nickname&quot;: &quot;系统管理员&quot;,//盘点人账号
                &quot;sg_type&quot;: 1,盘点类型（1整仓、2商品）
                &quot;check_time&quot;: &quot;2022-09-07 10:06:02&quot;//盘点时间
            },
            ......
        ],
        ......
        &quot;next_page_url&quot;: null,
        ......
        &quot;total&quot;: 4
    }
}
</code></pre><h2 id="-">指定盈亏查询盘点商品列表(适用盘点详情列表)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>查询信息</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/check_yk_goods_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>每页显示条数</td>
<td>integer</td>
<td>15</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>页码</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>yk_flag</td>
<td>否</td>
<td>否</td>
<td>盈亏标示：（1盈列表、2亏列表）注：字段不传，详情列表</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>check_no</td>
<td>是</td>
<td>否</td>
<td>盘点编号</td>
<td>integer</td>
<td>17897689678568</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>否</td>
<td>关键词（商品名称）</td>
<td>integer</td>
<td>保温箱</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
                {
                &quot;type_id&quot;: 35173,//物料id
                &quot;yk_flag&quot;: 1,//盈亏标示：（1盈列表、2亏列表）注：字段不传，详情列表
                &quot;materiel_name&quot;: &quot;二蛋&quot;,//物料商品名称
                &quot;materiel_img&quot;: &quot;/uploads/2022/08/25/2a5072d20ed1660e6dd79dd19e698041.png&quot;,//物料商品图片
                &quot;check_num&quot;: &quot;1700.000000&quot;,//盘点数量
                &quot;yk_num&quot;: &quot;100.000000&quot;,//盈亏数量
                &quot;in_storage_num&quot;: &quot;1800.000000&quot;,//在库数量
                &quot;shelf_name&quot;: null,//货架名称
                &quot;location_name&quot;: null,//货架仓位
                &quot;storage_name&quot;: &quot;1&quot;,//仓库名称
                &quot;type_name&quot;: &quot;a&quot;,//商品类型
                &quot;materiel_no&quot;: &quot;gARaMa6G&quot;//商品编号


            },
            ......
        ],
        ......
        &quot;next_page_url&quot;: null,
        ......
        &quot;total&quot;: 4
    }
}
</code></pre><h1 id="-zlf-">退货批次号列表（zlf）</h1>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>退货批次号列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/sales_return_batch_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>条数</td>
<td>integer</td>
<td>15</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>当前页码</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>materiel_type_id</td>
<td>是</td>
<td>否</td>
<td>商品id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
            {
                &quot;id&quot;: 10050,    //库存id
                &quot;in_storage_num&quot;: 2147483647,   //库存数
                &quot;materiel_type_id&quot;: 13313,  //商品id
                &quot;materiel_name&quot;: &quot;电脑&quot;,  //商品名
                &quot;type_name&quot;: &quot;TL&quot;,  //规格名
                &quot;materiel_no&quot;: &quot;doH7zpRr&quot;,  //商品编号
                &quot;materiel_img&quot;: &quot;/uploads/2022/06/18/B7okLs1pjwg3ObwlgKB0Iy5n9nvopIr49rrGYFjV.jpg&quot;, //商品图
                &quot;storage_id&quot;: 1836, //仓库id
                &quot;storage_name&quot;: &quot;5&quot;,    //仓库名
                &quot;batch_id&quot;: 20, //批次id
                &quot;batch_num&quot;: 100,   //批次数量
                &quot;batch_left_num&quot;: 100,    //批次剩余数量
                &quot;is_used&quot;: 0    //是否使用;0:否;1:是;
                &quot;batch_id&quot;: 39,
                &quot;in_storage_num&quot;: 10000,
                &quot;batch_no&quot;: &quot;zzz2022091215473794000&quot;//批次编号
            }
        ],
        &quot;total&quot;: 8
    }
}
</code></pre><h1 id="-zlf-">序列号列表（zlf）</h1>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>序列号列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/sales_return_serialnumber_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>条数</td>
<td>integer</td>
<td>15</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>当前页码</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>materiel_type_id</td>
<td>是</td>
<td>否</td>
<td>商品id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>status</td>
<td>否</td>
<td>否</td>
<td>1未使用，0使用（不传全部返回）</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>storage_manage_id</td>
<td>否</td>
<td>否</td>
<td>库存id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
            {
                &quot;id&quot;: 10050,    //库存id
                &quot;in_storage_num&quot;: 2147483647,   //库存数
                &quot;materiel_type_id&quot;: 13313,  //商品id
                &quot;materiel_name&quot;: &quot;电脑&quot;,  //商品名
                &quot;type_name&quot;: &quot;TL&quot;,  //规格名
                &quot;materiel_no&quot;: &quot;doH7zpRr&quot;,  //商品编号
                &quot;materiel_img&quot;: &quot;/uploads/2022/06/18/B7okLs1pjwg3ObwlgKB0Iy5n9nvopIr49rrGYFjV.jpg&quot;, //商品图
                &quot;storage_id&quot;: 1836, //仓库id
                &quot;storage_name&quot;: &quot;5&quot;,    //仓库名    
                &quot;serial_number_id&quot;: 35,//序列号id
                &quot;serial_no&quot;: &quot;tuihuo0003&quot;//序列号
            }
        ],
        &quot;total&quot;: 8
    }
}
</code></pre><blockquote>
<p>更新内容</p>
</blockquote>
<pre><code>`2022-09-29 15:16`:增加非必填参数`storage_manage_id`用于序列号调拨列表使用
</code></pre><h1 id="-zlf-">退货设置批次号(zlf)</h1>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>退货设置批次号</td>
<td>http</td>
<td>post</td>
<td>api/sales_return_add_batch</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>info</td>
<td>是</td>
<td>否</td>
<td>批次信息</td>
<td>json</td>
<td>15</td>
</tr>
<tr>
<td>return_id</td>
<td>是</td>
<td>否</td>
<td>退货单id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>type</td>
<td>是</td>
<td>否</td>
<td>类型;0:退货单内商品侧;1:退货单内套餐商品侧;</td>
<td>integer</td>
<td>13</td>
</tr>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>退货单内商品信息主键id或退货单内套餐商品信息主键id</td>
<td>integer</td>
<td>15</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>info</code>说明</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>batch_id</td>
<td>是</td>
<td>否</td>
<td>批次id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>storage_manage_id</td>
<td>是</td>
<td>否</td>
<td>库存id</td>
<td>integer</td>
<td>13</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>要使用的批次数量</td>
<td>integer</td>
<td>13</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h1 id="-author-sun-wu-">商品分类删除 (Author:Sun Wu)</h1>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>允许批量删除商品分类</td>
<td>http</td>
<td>post</td>
<td>/api/materiel_class_del</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>分类id(批量删除以英文逗号对id进行拼接)</td>
<td>string</td>
<td>1或1,2</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>取消`code`判定分类等级，改为自动识别分类对应的等级进行批量删除操作
</code></pre><h1 id="-author-sun-wu-">子账号列表 (Author:Sun Wu)</h1>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>编辑查询</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/user_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>页面大小</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>当前页</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>keyword</td>
<td>是</td>
<td>否</td>
<td>关键词</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,//当前页
        &quot;data&quot;: [
            {
                &quot;id&quot;: 1270,//用户id
                &quot;username&quot;: &quot;掌上出纳&quot;,//账号
                &quot;nickname&quot;: &quot;访客&quot;,//昵称
                &quot;mobile&quot;: &quot;&quot;,//手机号
                &quot;is_active&quot;: 1//是否启用;0:禁用;1:启用
                &quot;newpwd&quot;: &quot;722512&quot;, //密码
                &quot;updated_at&quot;: null //最近一次登录时间
            },
            {
                &quot;id&quot;: 1270,//用户id
                &quot;username&quot;: &quot;掌上出纳&quot;,//账号
                &quot;nickname&quot;: &quot;访客&quot;,//昵称
                &quot;mobile&quot;: &quot;&quot;,//手机号
                &quot;newpwd&quot;: &quot;817623&quot;,
                &quot;is_active&quot;: 1//是否启用;0:禁用;1:启用
                &quot;updated_at&quot;: &quot;2021-11-16 09:39:03&quot; //最近一次登录时间
            },
            ......
        ],
        &quot;total&quot;: &quot;10&quot;,//每页条数
    }
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-08-20 14:24`：增加返回参数`newpwd`
</code></pre><h1 id="-zl-">限制参数相关(zl)</h1>
<h2 id="-">限制参数列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>账号注销</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/field_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>页面大小</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>当前页</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>用户id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: [
        {
            &quot;id&quot;: 1,//字段id
            &quot;field_name&quot;: &quot;成本价&quot;, //字段名称
            &quot;is_enable&quot;: 1 //是否开启;0:否;1:是;
        },
        {
            &quot;id&quot;: 2,//字段id
            &quot;field_name&quot;: &quot;销售价&quot;, //字段名称
            &quot;is_enable&quot;: 1 //是否开启;0:否;1:是;
        }
    ]
}
</code></pre><h2 id="-">子账号权限设置(增加限制参数)</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>账号注销</td>
<td>http</td>
<td>post</td>
<td>api/set_user_permission</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>子账号用户id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>first_module</td>
<td>是</td>
<td>否</td>
<td>一级权限</td>
<td>string</td>
<td>6,21</td>
</tr>
<tr>
<td>second_module</td>
<td>否</td>
<td>否</td>
<td>二级权限</td>
<td>string</td>
<td>7,8,9,14,27,24,25,22</td>
</tr>
<tr>
<td>field</td>
<td>否</td>
<td>否</td>
<td>参数id(新增)</td>
<td>string</td>
<td>1,2</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h1 id="-zl-">微信支付参数相关(zl)</h1>
<h2 id="-">创建订单并支付</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>创建订单</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/wechat_pay</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>公共请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>type</td>
<td>是</td>
<td>否</td>
<td>支付商品类型 1 VIP充值 2 购买空间</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>pay_type</td>
<td>是</td>
<td>否</td>
<td>支付方式 1小程序 2app</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>code</td>
<td>否</td>
<td>否</td>
<td>微信用户CODE获取open_id使用</td>
<td>string</td>
<td>abcsd</td>
</tr>
<tr>
<td>space_id</td>
<td>否</td>
<td>否</td>
<td>当type=2时 传对应的商品ID</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>//小程序支付返回
{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;创建订单成功&quot;,
    &quot;data&quot;: {
        &quot;appId&quot;: &quot;wx20858b923b7ae99a&quot;,
        &quot;nonceStr&quot;: &quot;63009953c3b29&quot;,
        &quot;package&quot;: &quot;prepay_id=wx201620359868979208aab1b7ebb5090000&quot;,
        &quot;signType&quot;: &quot;MD5&quot;,
        &quot;paySign&quot;: &quot;7C8D6E346417B6CCE78BA5B23B5B3A60&quot;,
        &quot;timestamp&quot;: &quot;1660983635&quot;
    }
}
//app端返回
{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;创建订单成功&quot;,
    &quot;data&quot;: {
        &quot;appid&quot;: &quot;wx20858b923b7ae99a&quot;,
        &quot;partnerid&quot;: &quot;1574826081&quot;,
        &quot;prepayid&quot;: &quot;wx2016063021524082eca2f6dadbc5470000&quot;,
        &quot;noncestr&quot;: &quot;63009606059e0&quot;,
        &quot;timestamp&quot;: 1660982790,
        &quot;package&quot;: &quot;Sign=WXPay&quot;,
        &quot;sign&quot;: &quot;E67E9DFCBABAC7952A3144BFC160C837&quot;
    }
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-08-24 10:40`:增加`space_id`传参
</code></pre></blockquote>
<h1 id="-zl-">货架及库位(zl)</h1>
<h2 id="-">获取货架及库位</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/get_shelf</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>公共请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>storageId</td>
<td>是</td>
<td>否</td>
<td>仓库id</td>
<td>integer</td>
<td>1236</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: [
        {
            &quot;id&quot;: 1597,
            &quot;shelf_name&quot;: &quot;默认货架&quot;,
            &quot;shelf_type&quot;: 1,
            &quot;locations&quot;: [
                {
                    &quot;id&quot;: 1597,
                    &quot;location_name&quot;: &quot;默认库位&quot;,
                    &quot;shelf_id&quot;: 1597,
                    &quot;storage_id&quot;: 1867
                }
            ]
        },
        ......
    ]
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-09-07 10:18`:取消参数`currentPage`和`pageSize`并调整数据返回结构，变更`location_info`为`locations`
</code></pre><h2 id="-">创建货架</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>创建</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/shelf_create</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>公共请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>shelfName</td>
<td>是</td>
<td>否</td>
<td>货架名称</td>
<td>string</td>
<td>测试货架</td>
</tr>
<tr>
<td>storageId</td>
<td>是</td>
<td>否</td>
<td>仓库id</td>
<td>integer</td>
<td>1236</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>integer</td>
<td>备注</td>
</tr>
<tr>
<td>sort</td>
<td>否</td>
<td>否</td>
<td>排序</td>
<td>integer</td>
<td>2345</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;添加成功&quot;
}
</code></pre><h2 id="-">修改货架</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>修改</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/shelf_update</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>公共请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>shelfName</td>
<td>是</td>
<td>否</td>
<td>货架名称</td>
<td>string</td>
<td>测试货架</td>
</tr>
<tr>
<td>shelfId</td>
<td>是</td>
<td>否</td>
<td>货架id</td>
<td>integer</td>
<td>1236</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>integer</td>
<td>备注</td>
</tr>
<tr>
<td>sort</td>
<td>否</td>
<td>否</td>
<td>排序</td>
<td>integer</td>
<td>2345</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;修改成功&quot;
}
</code></pre><h2 id="-">删除货架</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>删除</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/shelf_del</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>公共请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>shelfId</td>
<td>是</td>
<td>否</td>
<td>货架id</td>
<td>integer</td>
<td>1236</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;删除成功&quot;
}
</code></pre><h2 id="-">创建库位</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>创建</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/location_create</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>公共请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>locationName</td>
<td>是</td>
<td>否</td>
<td>库位名称</td>
<td>string</td>
<td>测试库位</td>
</tr>
<tr>
<td>storageId</td>
<td>是</td>
<td>否</td>
<td>仓库id</td>
<td>integer</td>
<td>1236</td>
</tr>
<tr>
<td>shelfId</td>
<td>是</td>
<td>否</td>
<td>货架id</td>
<td>integer</td>
<td>2345</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>integer</td>
<td>备注</td>
</tr>
<tr>
<td>sort</td>
<td>否</td>
<td>否</td>
<td>排序</td>
<td>integer</td>
<td>2345</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;添加成功&quot;
}
</code></pre><h2 id="-">修改库位</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>修改</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/location_update</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>公共请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>locationName</td>
<td>是</td>
<td>否</td>
<td>库位名称</td>
<td>string</td>
<td>测试库位</td>
</tr>
<tr>
<td>locationId</td>
<td>是</td>
<td>否</td>
<td>库位id</td>
<td>integer</td>
<td>1236</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>integer</td>
<td>备注</td>
</tr>
<tr>
<td>sort</td>
<td>否</td>
<td>否</td>
<td>排序</td>
<td>integer</td>
<td>2345</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;修改成功&quot;
}
</code></pre><h2 id="-">删除库位</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>删除</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/location_del</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>公共请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>locationId</td>
<td>是</td>
<td>否</td>
<td>库位id</td>
<td>integer</td>
<td>1236</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;删除成功&quot;
}
</code></pre><h2 id="-">仓库货架库位三级列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>删除</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/storage_shelf_location</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: [
        {
            &quot;id&quot;: 3999,
            &quot;storage_id&quot;: 3999, //仓库id
            &quot;storage_name&quot;: &quot;1&quot;,    //仓库名
            &quot;storage_address&quot;: &quot;1&quot;, //仓库地址
            &quot;shelf_list&quot;: [
                {
                    &quot;id&quot;: 3376,
                    &quot;shelf_id&quot;: 3376,   //货架id
                    &quot;shelf_name&quot;: &quot;默认货架&quot;,   //货架名
                    &quot;storage_id&quot;: 3999, //
                    &quot;location_list&quot;: [
                        {
                            &quot;location_id&quot;: 3376,    //库位id
                            &quot;shelf_id&quot;: 3376,   //
                            &quot;location_name&quot;: &quot;默认库位&quot; //库位名
                        }
                    ]
                }
            ]
        },
        ......
    ]
}
</code></pre><h2 id="-">货架列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/shelf_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>公共请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>storageId</td>
<td>是</td>
<td>否</td>
<td>仓库id</td>
<td>integer</td>
<td>1236</td>
</tr>
<tr>
<td>searchData</td>
<td>是</td>
<td>否</td>
<td>查询条件</td>
<td>string</td>
<td>货架名称</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: [
        {
            &quot;shelf_id&quot;: 1613,
            &quot;shelf_name&quot;: &quot;测试货架1&quot;,
            &quot;shelf_type&quot;: 2 //货架类型 1默认货架 2用户创建的
        },
    ]
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-09-07 10:47`：取消参数`currentPage`和`pageSize`
</code></pre><h2 id="-">货架详情</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>详情</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/shelf_info</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>公共请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>shelfId</td>
<td>是</td>
<td>否</td>
<td>货架ID</td>
<td>integer</td>
<td>6</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;获取成功&quot;,
    &quot;data&quot;: {
        &quot;storage_name&quot;: &quot;shop1&quot;, //所属仓库名称
        &quot;storage_id&quot;: 1872,
        &quot;shelf_id&quot;: 1613,
        &quot;shelf_name&quot;: &quot;测试货架1&quot;,
        &quot;remark&quot;: &quot;bz&quot;,  //备注
        &quot;sort&quot;: 11 //排序
    }
}
</code></pre><h2 id="-">库位列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/location_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>公共请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>shelfId</td>
<td>是</td>
<td>否</td>
<td>货架id</td>
<td>integer</td>
<td>1236</td>
</tr>
<tr>
<td>searchData</td>
<td>是</td>
<td>否</td>
<td>查询条件</td>
<td>string</td>
<td>库位名称</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: [
        {
            &quot;location_id&quot;: 1615,
            &quot;location_name&quot;: &quot;测试库位ab&quot;,
            &quot;location_type&quot;: 2, //库位类型 1默认库位 2用户创建的
            &quot;is_null&quot;: 1 //是否为空
        }
    ]
}
</code></pre><blockquote>
<p>变更内容</p>
</blockquote>
<pre><code>`2022-09-07 10:56`：取消参数`currentPage`和`pageSize`
</code></pre><h2 id="-">库位详情</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>详情</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/location_info</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>公共请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>locationId</td>
<td>是</td>
<td>否</td>
<td>库位ID</td>
<td>integer</td>
<td>6</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;获取成功&quot;,
    &quot;data&quot;: {
        &quot;storage_name&quot;: &quot;shop1&quot;, //所属仓库名称
        &quot;storage_id&quot;: 1872, 
        &quot;shelf_id&quot;: 1613, //所属货架名称
        &quot;shelf_name&quot;: &quot;测试货架1&quot;,
        &quot;location_id&quot;: 1615, 
        &quot;location_name&quot;: &quot;测试库位ab&quot;,
        &quot;remark&quot;: &quot;bz&quot;, //备注
        &quot;sort&quot;: 1000 //排序
    }
}
</code></pre><h1 id="-zl-">套餐相关修改（zl）</h1>
<h2 id="-">添加套餐内容-可用库存物料信息修改</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>编辑查询</td>
<td>http</td>
<td>post</td>
<td>api/package_content_select</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>套餐id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>页面大小</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>当前页</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>materiel_class_id</td>
<td>否</td>
<td>是</td>
<td>物料所属二级分类id</td>
<td>integer</td>
<td>107</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>是</td>
<td>关键词(支持<code>物料名</code>,<code>物料型号</code>,<code>物料编号</code>)</td>
<td>string</td>
<td>电子体温计</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,//当前页
        &quot;data&quot;: [
            {
                &quot;id&quot;: 537,//库存id
                &quot;materiel_class_id&quot;: 9,//物料二级分类id
                &quot;materiel_class_name&quot;: &quot;护肤品套装&quot;,//二级分类名称
                &quot;class_no&quot;: &quot;&quot;,//二级分类编号
                &quot;type_id&quot;: 557,//物料id
                &quot;materiel_name&quot;: &quot;丽肤宝透明质酸补水保湿套盒&quot;,//物料名称
                &quot;type_name&quot;: &quot;5件套&quot;,//物料型号
                &quot;materiel_no&quot;: &quot;&quot;,//物料编号
                &quot;materiel_mean_cost&quot;: &quot;0.00&quot;,//物料成本价
                &quot;storage_id&quot;: 48,//仓库id
                &quot;storage_name&quot;: &quot;B1-9栋&quot;,//所在仓库
                &quot;storage_address&quot;: &quot;B1-9栋&quot;,//所在仓库地址
                &quot;in_storage_num&quot;: 128,//库存数
                &quot;alert_num&quot;: 0,//低库存预警数
                &quot;class_name&quot;: &quot;美妆用品&quot;,//一级分类名称
                &quot;f_class_no&quot;: &quot;&quot;//一级分类编号,
                &quot;content_exist&quot;: 0//是否已添加至当前套餐内
                &quot;shelf_id&quot;: 1613, //货架ID
                &quot;location_id&quot;: 1614,//库位ID
                &quot;shelf_name&quot;: &quot;测试货架1&quot;, //货架名称
                &quot;location_name&quot;: &quot;测试库位2&quot; //库位名称
            },
            ......
        ],
        &quot;total&quot;: &quot;10&quot;,//页面大小
    }
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-08-25 16:40`:增加`shelf_id`,`location_id`,`shelf_name`,`location_name`返回 
</code></pre></blockquote>
<h1 id="-zl-">退货单相关修改(zl)</h1>
<h2 id="-">列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>添加列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/sales_return_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>页面大小</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>当前页</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>repeal_status</td>
<td>是</td>
<td>否</td>
<td>撤销状态：0-未撤销 1-已撤销</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
            {
                &quot;id&quot;: 7,                        退货单主键id
                &quot;main_id&quot;: 7,
                &quot;user_id&quot;: 7,
                &quot;customer_name&quot;: &quot;孙子&quot;,        客户姓名
                &quot;proof_image&quot;: &quot;ii.png&quot;,        凭证图片(多图逗号分隔)
                &quot;discount&quot;: 80,                 折扣 ：百分比
                &quot;tax_rate&quot;: 13,                 税率 ：百分比
                &quot;final_money&quot;: &quot;51&quot;,            实际应收金额（即折扣或抹零后价格或改价金额）
                &quot;money&quot;: &quot;55.20&quot;,               货款金额（纯商品金额）
                &quot;real_money&quot;: &quot;10.00&quot;,          实收金额（实际入账）
                &quot;is_zero_suppression&quot;: 0,       是否改价：0-否 1-是
                &quot;remark&quot;: &quot;hhh&quot;,                备注
                &quot;out_order_no&quot;: &quot;fasdfadsggogjhdghpa&quot;,      外部单号
                &quot;order_no&quot;: &quot;ST71635925491557&quot;,             订单号
                &quot;out_status&quot;: 0,                            出库状态：0-待出库 1-部分出库 2-全部出库
                &quot;pay_status&quot;: 0,                            付款状态：0-待付款 1-部分付款 2-全部付款
                &quot;refund_date&quot;: &quot;2021-09-08 00:00:00&quot;,       退货时间
                &quot;repeal_status&quot;: 0,                         撤销状态：0-未撤销 1-已撤销
                &quot;created_at&quot;: &quot;2021-11-03 15:44:51&quot;,
                &quot;updated_at&quot;: &quot;2021-11-03 15:55:34&quot;,
                &quot;username&quot;: &quot;15505523456&quot;,      操作人
                &quot;return_materiel&quot;: [
                    {
                        &quot;id&quot;: 64,
                        &quot;name&quot;: &quot;测试1&quot;,
                        &quot;type_name&quot;: &quot;型号1&quot;,
                        &quot;materiel_no&quot;: &quot;ol1Tpi3Y&quot;,
                        &quot;image&quot;: &quot;&quot;,
                        &quot;price&quot;: &quot;10.000000&quot;,
                        &quot;num&quot;: &quot;200.000000&quot;,
                        &quot;in_num&quot;: &quot;200.000000&quot;,
                        &quot;warehouse&quot;: &quot;shop1&quot;,
                        &quot;warehouse_id&quot;: 1872,
                        &quot;materiel_type_id&quot;: 35069,
                        &quot;return_id&quot;: 45,
                        &quot;cost_price&quot;: &quot;1.000000&quot;,
                        &quot;shelf_id&quot;: 1613, //货架ID
                        &quot;location_id&quot;: 1614,//库位ID
                        &quot;shelf_name&quot;: &quot;测试货架1&quot;, //货架名称
                        &quot;location_name&quot;: &quot;测试库位2&quot; //库位名称
                        &quot;in_storage_num&quot;: null
                    }
                ],
            },
            {
                &quot;id&quot;: 47,
                &quot;main_id&quot;: 4664,
                &quot;user_id&quot;: 4664,
                &quot;customer_id&quot;: 525,
                &quot;customer_name&quot;: &quot;客户、&quot;,
                &quot;consignee&quot;: &quot;&quot;,
                &quot;phone&quot;: &quot;&quot;,
                &quot;address&quot;: &quot;&quot;,
                &quot;proof_image&quot;: null,
                &quot;discount&quot;: null,
                &quot;tax_rate&quot;: null,
                &quot;final_money&quot;: &quot;100.000000&quot;,
                &quot;money&quot;: &quot;100.000000&quot;,
                &quot;real_money&quot;: &quot;0.000000&quot;,
                &quot;is_zero_suppression&quot;: 0,
                &quot;remark&quot;: null,
                &quot;out_order_no&quot;: &quot;&quot;,
                &quot;order_no&quot;: &quot;ST46641661416882521&quot;,
                &quot;out_status&quot;: 2,
                &quot;pay_status&quot;: 0,
                &quot;refund_date&quot;: &quot;2022-08-25 14:30:17&quot;,
                &quot;repeal_status&quot;: 0,
                &quot;delete_flag&quot;: 0,
                &quot;created_at&quot;: &quot;2022-08-25 16:41:22&quot;,
                &quot;updated_at&quot;: &quot;2022-08-25 16:42:41&quot;,
                &quot;username&quot;: &quot;13774408836&quot;,
                &quot;nickname&quot;: &quot;访客&quot;,
                &quot;return_materiel&quot;: [],
                &quot;return_package&quot;: [
                    {
                        &quot;id&quot;: 19,
                        &quot;package_name&quot;: &quot;新套餐1&quot;,
                        &quot;price&quot;: &quot;1.00&quot;,
                        &quot;cost_price&quot;: &quot;5.00&quot;,
                        &quot;num&quot;: 100,
                        &quot;in_num&quot;: 100,
                        &quot;return_id&quot;: 47,
                        &quot;package_content&quot;: [
                            {
                                &quot;id&quot;: 32,
                                &quot;type_id&quot;: 35070,
                                &quot;materiel_name&quot;: &quot;测试2&quot;,
                                &quot;type_name&quot;: &quot;型号2&quot;,
                                &quot;materiel_no&quot;: &quot;00JvmCY9&quot;,
                                &quot;materiel_img&quot;: &quot;&quot;,
                                &quot;materiel_class_id&quot;: 10367,
                                &quot;class_name&quot;: &quot;一级子类&quot;,
                                &quot;storage_id&quot;: 1872,
                                &quot;num&quot;: &quot;5.000000&quot;,
                                &quot;storage_manage_id&quot;: 32,
                                &quot;return_package_id&quot;: 19,
                                &quot;storage_name&quot;: &quot;shop1&quot;,
                                &quot;storage_address&quot;: &quot;安徽蚌埠&quot;,
                                &quot;materiel_class_name&quot;: &quot;一级子类&quot;,
                                &quot;materiel_class_no&quot;: &quot;vAKc&quot;,
                                &quot;materiel_mean_cost&quot;: &quot;1.000000&quot;,
                                &quot;in_storage_num&quot;: &quot;2017.000000&quot;,
                                &quot;virtual_storage_num&quot;: &quot;2017.000000&quot;,
                                &quot;alert_num&quot;: &quot;0.000000&quot;,
                                &quot;materiel_original&quot;: 0,
                                &quot;main_id&quot;: 4664,
                                &quot;in_storage_time&quot;: 1661335715,
                                &quot;delete_flag&quot;: 0,
                                &quot;created_at&quot;: &quot;2022-08-24 18:08:35&quot;,
                                &quot;updated_at&quot;: &quot;2022-08-25 18:02:22&quot;,
                                &quot;shelf_id&quot;: 1613,
                                &quot;location_id&quot;: 1614,
                                &quot;shelf_name&quot;: &quot;测试货架1&quot;, //货架名称
                                &quot;location_name&quot;: &quot;测试库位2&quot; //库位名称
                            },
                            {
                                &quot;id&quot;: 29,
                                &quot;type_id&quot;: 35069,
                                &quot;materiel_name&quot;: &quot;测试1&quot;,
                                &quot;type_name&quot;: &quot;型号1&quot;,
                                &quot;materiel_no&quot;: &quot;ol1Tpi3Y&quot;,
                                &quot;materiel_img&quot;: &quot;&quot;,
                                &quot;materiel_class_id&quot;: 10367,
                                &quot;class_name&quot;: &quot;一级子类&quot;,
                                &quot;storage_id&quot;: 1872,
                                &quot;num&quot;: &quot;100.000000&quot;,
                                &quot;storage_manage_id&quot;: 29,
                                &quot;return_package_id&quot;: 19,
                                &quot;storage_name&quot;: &quot;shop1&quot;,
                                &quot;storage_address&quot;: &quot;安徽蚌埠&quot;,
                                &quot;materiel_class_name&quot;: &quot;一级子类&quot;,
                                &quot;materiel_class_no&quot;: &quot;vAKc&quot;,
                                &quot;materiel_mean_cost&quot;: &quot;1.000000&quot;,
                                &quot;in_storage_num&quot;: &quot;31431.000000&quot;,
                                &quot;virtual_storage_num&quot;: &quot;31431.000000&quot;,
                                &quot;alert_num&quot;: &quot;0.000000&quot;,
                                &quot;materiel_original&quot;: 0,
                                &quot;main_id&quot;: 4664,
                                &quot;in_storage_time&quot;: 1661331255,
                                &quot;delete_flag&quot;: 0,
                                &quot;created_at&quot;: &quot;2022-08-24 16:54:15&quot;,
                                &quot;updated_at&quot;: &quot;2022-08-25 18:02:22&quot;,

                                &quot;shelf_id&quot;: 1613,
                                &quot;location_id&quot;: 1614,
                                &quot;shelf_name&quot;: &quot;测试货架1&quot;, //货架名称
                                &quot;location_name&quot;: &quot;测试库位2&quot; //库位名称
                            }
                        ]
                    }
                ]
            },
        ],
        &quot;total&quot;: &quot;10&quot;,  总条数
    }
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-08-25 16:40`:增加`shelf_id`,`location_id`,`shelf_name`,`location_name`返回 
</code></pre></blockquote>
<h2 id="-">详细</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>退货单详细</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/sales_return_find（detail_sales_return_find[无token]）</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>退货主键id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 7,                        退货单主键id
        &quot;main_id&quot;: 7,
        &quot;user_id&quot;: 7,
        &quot;customer_name&quot;: &quot;孙子&quot;,        客户姓名
        &quot;proof_image&quot;: &quot;ii.png&quot;,        凭证图片(多图逗号分隔)
        &quot;discount&quot;: 80,                 折扣 ：百分比
        &quot;tax_rate&quot;: 13,                 税率 ：百分比
        &quot;final_money&quot;: &quot;51&quot;,            实际应收金额（即折扣或抹零后价格或改价金额）
        &quot;money&quot;: &quot;55.20&quot;,               货款金额（纯商品金额）
        &quot;real_money&quot;: &quot;10.00&quot;,          实收金额（实际入账）
        &quot;is_zero_suppression&quot;: 0,       是否改价：0-否 1-是
        &quot;remark&quot;: &quot;hhh&quot;,                备注
        &quot;out_order_no&quot;: &quot;fasdfadsggogjhdghpa&quot;,      外部单号
        &quot;order_no&quot;: &quot;ST71635925491557&quot;,             订单号
        &quot;out_status&quot;: 0,                            出库状态：0-待出库 1-部分出库 2-全部出库
        &quot;pay_status&quot;: 0,                            付款状态：0-待付款 1-部分付款 2-全部付款
        &quot;refund_date&quot;: &quot;2021-09-08 00:00:00&quot;,       退货时间
        &quot;repeal_status&quot;: 0,                         撤销状态：0-未撤销 1-已撤销
        &quot;created_at&quot;: &quot;2021-11-03 15:44:51&quot;,
        &quot;updated_at&quot;: &quot;2021-11-03 15:55:34&quot;,
        &quot;return_materiel&quot;: [
            {
                &quot;materiel_type_id&quot;: 1, 商品关联id
                &quot;name&quot;: &quot;测试&quot;,             商品名称
                &quot;type_name&quot;: &quot;规格&quot;,        型号
                &quot;price&quot;: &quot;2.30&quot;,            售价
                &quot;cost_price&quot;: &quot;0.00&quot;,
                &quot;num&quot;: 2,                   商品数量
                &quot;image&quot;: &quot;商品图片地址&quot;,    商品图片
                &quot;warehouse&quot;: &quot;仓库名称&quot;,    仓库名称
                &quot;warehouse_id&quot;: 1,      
                &quot;piece&quot;: 0,                 件数
                &quot;return_id&quot;: 30,            退货单主键id
                &quot;in_storage_num&quot;: 2         在库数量
                &quot;in_num&quot;: 0,                已入库数量
                &quot;is_in&quot;: 0,                 是否入库： 1-是  0-否
                &quot;materiel_no&quot;: &quot;&quot;, 商品编号
                &quot;is_use_serial&quot;: 0,//开启序列号
                serial_number_list&quot;: [//序列号
                &quot;xiaoshou01&quot;,
                &quot;xiaoshou02&quot;,
                &quot;xiaoshou03&quot;
                ],
                &quot;goods_batch_list&quot;: [/批次号                
                    &quot;smyc2022082516171255700&quot;,
                    &quot;smyc2022082516193719990&quot;
                    ],

            }
        ],
        &quot;return_package&quot;: [
            {
                &quot;id&quot;: 3,    //退货单套餐id
                &quot;package_id&quot;: 52,   //套餐id
                &quot;price&quot;: &quot;60.00&quot;,   //售价
                &quot;cost_price&quot;: &quot;12.00&quot;,  //成本价(套餐内每个商品成本*各自组成数量)
                &quot;num&quot;: 22,  //套餐数量
                &quot;in_num&quot;: 0,    //已入库数量
                &quot;is_in&quot;: 0, //是否入库： 1-是  0-否
                &quot;main_id&quot;: 7,
                &quot;return_id&quot;: 6, //退货单主键id
                &quot;created_at&quot;: &quot;2022-04-29 16:14:18&quot;,
                &quot;updated_at&quot;: null, //
                &quot;package_name&quot;: &quot;老蓝，5L保温箱+温度显示+1蓝冰+6冰袋&quot;,    //套餐名
                &quot;package_content&quot;: [
                    {
                        &quot;id&quot;: 1,    //销售单套餐内容id
                        &quot;type_id&quot;: 31,  //商品id
                        &quot;storage_id&quot;: 33,   //仓库id
                        &quot;package_content_id&quot;: 128,  //套餐原始内容id
                        &quot;storage_manage_id&quot;: 1843,  //库存id
                        &quot;return_package_id&quot;: 3, //关联退货单套餐id
                        &quot;package_id&quot;: 52,   //原始套餐id
                        &quot;num&quot;: 10,  //组成数量
                        &quot;in_num&quot;: 0,    //已入库数量
                        &quot;main_id&quot;: 7,   
                        &quot;return_id&quot;: 6, //退货单主键id
                        &quot;created_at&quot;: &quot;2022-04-29 16:14:18&quot;,    
                        &quot;updated_at&quot;: null, 
                        &quot;materiel_name&quot;: &quot;保温箱5L&quot;,   //商品名
                        &quot;type_name&quot;: &quot;5L&quot;,  //商品规格名
                        &quot;storage_name&quot;: &quot;B2-6&quot;, //仓库名
                        &quot;storage_address&quot;: &quot;b 2-6&quot;, //仓库地址
                        &quot;in_storage_num&quot;: 10000 //当前库存数量
                        &quot;materiel_no&quot;: &quot;&quot;, 商品编号
                        &quot;materiel_class_id&quot;: 69, 商品二级分类id
                        &quot;class_name&quot;: &quot;保温箱&quot;  商品分类名                        
                        &quot;materiel_img&quot;: &quot;&quot;,//商品图片
                        &quot;selling_price&quot;: &quot;10.000000&quot;,//商品销售价格
                        &quot;shelf_name&quot;: &quot;默认货架&quot;,//货架
                        &quot;location_name&quot;: &quot;默认库位&quot;//库位
                        &quot;is_use_serial&quot;: 0,//开启序列号
                         serial_number_list&quot;: [//序列号
                        &quot;xiaoshou01&quot;,
                        &quot;xiaoshou02&quot;,
                        &quot;xiaoshou03&quot;
                        ],
                        &quot;goods_batch_list&quot;: [//批次号                    
                            &quot;smyc2022082516171255700&quot;,
                            &quot;smyc2022082516193719990&quot;
                            ],
                    }
                ]
            }
        ]
    }
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-08-25 16:40`:增加`shelf_id`,`location_id`,`shelf_name`,`location_name`,`materiel_img`,`selling_price`返回 
`2022-09-13 10:10`:增加`is_use_serial`,`serial_number_list`,`goods_batch_list`返回 
</code></pre></blockquote>
<h2 id="-">添加</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>添加退货单</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/sales_return_add</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>customer_name</td>
<td>是</td>
<td>否</td>
<td>客户姓名</td>
<td>string</td>
<td>杨总</td>
</tr>
<tr>
<td>goods_info</td>
<td>是</td>
<td>否</td>
<td>商品信息</td>
<td>array</td>
<td>[{&quot;materiel_type_id&quot;:35069,&quot;price&quot;:&quot;10&quot;,&quot;num&quot;:&quot;200&quot;,&quot;warehouse_id&quot;:1872,&quot;shelf_id&quot;:1613,&quot;location_id&quot;:1614}]</td>
</tr>
<tr>
<td>package_info</td>
<td>是</td>
<td>否</td>
<td>商品信息</td>
<td>array</td>
<td>[{&quot;price&quot;:&quot;1&quot;,&quot;num&quot;:&quot;100&quot;,&quot;package_id&quot;:510,&quot;name&quot;:&quot;新套餐1&quot;,&quot;package_content&quot;:[{&quot;allName&quot;:&quot;测试2/型号2(00JvmCY9)&quot;,&quot;id&quot;:359,&quot;type_id&quot;:35070,&quot;num&quot;:&quot;5&quot;,&quot;materiel_class_id&quot;:10367,&quot;storage_id&quot;:1872,&quot;storage_manage_id&quot;:32,&quot;shelf_id&quot;:1613,&quot;location_id&quot;:1614},{&quot;allName&quot;:&quot;测试1/型号1(ol1Tpi3Y)&quot;,&quot;id&quot;:360,&quot;type_id&quot;:35069,&quot;num&quot;:&quot;100&quot;,&quot;materiel_class_id&quot;:10367,&quot;storage_id&quot;:1872,&quot;storage_manage_id&quot;:29,&quot;shelf_id&quot;:1613,&quot;location_id&quot;:1614}]}]</td>
</tr>
<tr>
<td>discount</td>
<td>否</td>
<td>否</td>
<td>折扣 ：百分比</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>tax_rate</td>
<td>否</td>
<td>否</td>
<td>税率 ：百分比</td>
<td>integer</td>
<td>13</td>
</tr>
<tr>
<td>is_zero_suppression</td>
<td>是</td>
<td>否</td>
<td>是否抹零：0-否 1-是</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>final_money</td>
<td>否</td>
<td>否</td>
<td>实际应收金额（即折扣或抹零后价格）如果是抹零此参数必传</td>
<td>string</td>
<td>10.99</td>
</tr>
<tr>
<td>real_money</td>
<td>否</td>
<td>否</td>
<td>实收金额（实际入账）</td>
<td>string</td>
<td>10.99</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>杨总</td>
</tr>
<tr>
<td>out_order_no</td>
<td>否</td>
<td>否</td>
<td>外部单号</td>
<td>string</td>
<td>jojdojfo903u40jgi</td>
</tr>
<tr>
<td>refund_date</td>
<td>是</td>
<td>否</td>
<td>退货时间</td>
<td>date</td>
<td>2021-11-01 20:20:20</td>
</tr>
<tr>
<td>proof_image</td>
<td>否</td>
<td>否</td>
<td>凭证图片(多图逗号分隔)</td>
<td>string</td>
<td>./kkkk.png</td>
</tr>
</tbody>
</table>
<blockquote>
<p>goods_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>materiel_type_id</td>
<td>是</td>
<td>否</td>
<td>商品关联id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>price</td>
<td>是</td>
<td>否</td>
<td>价格</td>
<td>string</td>
<td>3</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>warehouse</td>
<td>是</td>
<td>否</td>
<td>仓库名称</td>
<td>string</td>
<td>一仓</td>
</tr>
<tr>
<td>warehouse_id</td>
<td>是</td>
<td>否</td>
<td>仓库主键id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>shelf_id</td>
<td>是</td>
<td>否</td>
<td>货架ID</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>location_id</td>
<td>是</td>
<td>否</td>
<td>库位ID</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>package_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>price</td>
<td>是</td>
<td>否</td>
<td>价格</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>package_id</td>
<td>是</td>
<td>否</td>
<td>套餐id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>name</td>
<td>是</td>
<td>否</td>
<td>套餐名称</td>
<td>string</td>
<td>新套餐</td>
</tr>
<tr>
<td>package_content</td>
<td>是</td>
<td>否</td>
<td>套餐名称</td>
<td>array</td>
<td>套餐内容</td>
</tr>
<tr>
<td>allName</td>
<td>是</td>
<td>否</td>
<td>商品全称</td>
<td>string</td>
<td>测试2/型号2(00JvmCY9)</td>
</tr>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>套餐内容ID</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>type_id</td>
<td>是</td>
<td>否</td>
<td>商品ID</td>
<td>integer</td>
<td>1       </td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>materiel_class_id</td>
<td>是</td>
<td>否</td>
<td>商品分类id</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>storage_id</td>
<td>是</td>
<td>否</td>
<td>仓库ID</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>storage_manage_id</td>
<td>是</td>
<td>否</td>
<td>库存ID</td>
<td>integer</td>
<td>32</td>
</tr>
<tr>
<td>shelf_id</td>
<td>是</td>
<td>否</td>
<td>货架ID</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>location_id</td>
<td>是</td>
<td>否</td>
<td>库位ID</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: 32      退货单主键id
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-08-25 16:40`:请求参数 goods_info 增加`shelf_id`,`location_id`
</code></pre></blockquote>
<h2 id="-">入库</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>入库</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/sales_return_in</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>退货单主键id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>status</td>
<td>是</td>
<td>否</td>
<td>出入库状态：0-部分 1-全部</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>goods_info</td>
<td>是</td>
<td>否</td>
<td>商品信息</td>
<td>array</td>
<td>[{&quot;materiel_type_id&quot;:35171,&quot;price&quot;:&quot;10&quot;,&quot;num&quot;:&quot;1&quot;,&quot;warehouse_id&quot;:1867,&quot;shelf_id&quot;:1597,&quot;location_id&quot;:1597,&quot;batch_info&quot;:[{&quot;batch_id&quot;:288,&quot;num&quot;:&quot;1.000000&quot;,&quot;storage_manage_id&quot;:135}]}]</td>
</tr>
<tr>
<td>package_info</td>
<td>是</td>
<td>否</td>
<td>商品信息</td>
<td>array</td>
<td>[{&quot;package_id&quot;:520,&quot;price&quot;:&quot;1&quot;,&quot;num&quot;:10,&quot;package_content&quot;:[{&quot;id&quot;:88,&quot;type_id&quot;:35172,&quot;num&quot;:&quot;100&quot;,&quot;materiel_class_id&quot;:10389,&quot;storage_id&quot;:1867,&quot;storage_manage_id&quot;:136,&quot;serial_no&quot;:&quot;333333333331&quot;,&quot;batch_info&quot;:[{&quot;batch_id&quot;:289,&quot;num&quot;:&quot;1.000000&quot;,&quot;storage_manage_id&quot;:136}]},{&quot;id&quot;:87,&quot;type_id&quot;:35173,&quot;num&quot;:&quot;1.000000&quot;,&quot;materiel_class_id&quot;:10389,&quot;storage_id&quot;:1867,&quot;storage_manage_id&quot;:138,&quot;serial_no&quot;:&quot;222222222221&quot;,&quot;batch_info&quot;:[{&quot;batch_id&quot;:289,&quot;num&quot;:&quot;1.000000&quot;,&quot;storage_manage_id&quot;:136}]}],&quot;remark&quot;:&quot;&quot;}]</td>
</tr>
<tr>
<td>in_storage_time</td>
<td>是</td>
<td>否</td>
<td>入库时间</td>
<td>date</td>
<td>2021-09-09 20:20:11</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>备注</td>
</tr>
</tbody>
</table>
<blockquote>
<p>goods_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>materiel_type_id</td>
<td>是</td>
<td>否</td>
<td>商品关联id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>price</td>
<td>是</td>
<td>否</td>
<td>价格</td>
<td>string</td>
<td>3</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>package_id</td>
<td>否</td>
<td>否</td>
<td>套餐ID</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>&quot;&quot;</td>
</tr>
<tr>
<td>warehouse_id</td>
<td>是</td>
<td>否</td>
<td>仓库主键id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>shelf_id</td>
<td>是</td>
<td>否</td>
<td>货架ID</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>location_id</td>
<td>是</td>
<td>否</td>
<td>库位ID</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>serial_no</td>
<td>是</td>
<td>否</td>
<td>序列号</td>
<td>string</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>package_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>price</td>
<td>是</td>
<td>否</td>
<td>价格</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>package_id</td>
<td>是</td>
<td>否</td>
<td>套餐id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>name</td>
<td>是</td>
<td>否</td>
<td>套餐名称</td>
<td>string</td>
<td>新套餐</td>
</tr>
<tr>
<td>package_content</td>
<td>是</td>
<td>否</td>
<td>套餐名称</td>
<td>array</td>
<td>套餐内容</td>
</tr>
<tr>
<td>allName</td>
<td>是</td>
<td>否</td>
<td>商品全称</td>
<td>string</td>
<td>测试2/型号2(00JvmCY9)</td>
</tr>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>套餐内容ID</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>type_id</td>
<td>是</td>
<td>否</td>
<td>商品ID</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>materiel_class_id</td>
<td>是</td>
<td>否</td>
<td>商品分类id</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>storage_id</td>
<td>是</td>
<td>否</td>
<td>仓库ID</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>storage_manage_id</td>
<td>是</td>
<td>否</td>
<td>库存ID</td>
<td>integer</td>
<td>32</td>
</tr>
<tr>
<td>shelf_id</td>
<td>是</td>
<td>否</td>
<td>货架ID</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>location_id</td>
<td>是</td>
<td>否</td>
<td>库位ID</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>serial_no</td>
<td>是</td>
<td>否</td>
<td>序列号</td>
<td>string</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>batch_info</code></p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>batch_id</td>
<td>是</td>
<td>否</td>
<td>批次主键id</td>
<td>string</td>
<td>3</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>storage_manage_id</td>
<td>是</td>
<td>否</td>
<td>库存id</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-9-5 16:40`:请求参数增加 增加`serial_no`
`2022-08-25 16:40`:请求参数 goods_info 增加`shelf_id`,`location_id`
`2022-09-13 10:40`:请求参数 batch_info 增加`batch_id`,`num`,`storage_manage_id`
</code></pre></blockquote>
<h2 id="-">修改</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>添加退货单</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/sales_return_edit</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>customer_name</td>
<td>是</td>
<td>否</td>
<td>客户姓名</td>
<td>string</td>
<td>杨总</td>
</tr>
<tr>
<td>goods_info</td>
<td>是</td>
<td>否</td>
<td>商品信息</td>
<td>array</td>
<td>[{&quot;materiel_type_id&quot;:35069,&quot;price&quot;:&quot;10&quot;,&quot;num&quot;:&quot;200&quot;,&quot;warehouse_id&quot;:1872,&quot;shelf_id&quot;:1613,&quot;location_id&quot;:1614}]</td>
</tr>
<tr>
<td>package_info</td>
<td>是</td>
<td>否</td>
<td>商品信息</td>
<td>array</td>
<td>[{&quot;price&quot;:&quot;1&quot;,&quot;num&quot;:&quot;100&quot;,&quot;package_id&quot;:510,&quot;name&quot;:&quot;新套餐1&quot;,&quot;package_content&quot;:[{&quot;allName&quot;:&quot;测试2/型号2(00JvmCY9)&quot;,&quot;id&quot;:359,&quot;type_id&quot;:35070,&quot;num&quot;:&quot;5&quot;,&quot;materiel_class_id&quot;:10367,&quot;storage_id&quot;:1872,&quot;storage_manage_id&quot;:32,&quot;shelf_id&quot;:1613,&quot;location_id&quot;:1614},{&quot;allName&quot;:&quot;测试1/型号1(ol1Tpi3Y)&quot;,&quot;id&quot;:360,&quot;type_id&quot;:35069,&quot;num&quot;:&quot;100&quot;,&quot;materiel_class_id&quot;:10367,&quot;storage_id&quot;:1872,&quot;storage_manage_id&quot;:29,&quot;shelf_id&quot;:1613,&quot;location_id&quot;:1614}]}]</td>
</tr>
<tr>
<td>discount</td>
<td>否</td>
<td>否</td>
<td>折扣 ：百分比</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>tax_rate</td>
<td>否</td>
<td>否</td>
<td>税率 ：百分比</td>
<td>integer</td>
<td>13</td>
</tr>
<tr>
<td>is_zero_suppression</td>
<td>是</td>
<td>否</td>
<td>是否抹零：0-否 1-是</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>final_money</td>
<td>否</td>
<td>否</td>
<td>实际应收金额（即折扣或抹零后价格）如果是抹零此参数必传</td>
<td>string</td>
<td>10.99</td>
</tr>
<tr>
<td>real_money</td>
<td>否</td>
<td>否</td>
<td>实收金额（实际入账）</td>
<td>string</td>
<td>10.99</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>杨总</td>
</tr>
<tr>
<td>out_order_no</td>
<td>否</td>
<td>否</td>
<td>外部单号</td>
<td>string</td>
<td>jojdojfo903u40jgi</td>
</tr>
<tr>
<td>refund_date</td>
<td>是</td>
<td>否</td>
<td>退货时间</td>
<td>date</td>
<td>2021-11-01 20:20:20</td>
</tr>
<tr>
<td>proof_image</td>
<td>否</td>
<td>否</td>
<td>凭证图片(多图逗号分隔)</td>
<td>string</td>
<td>./kkkk.png</td>
</tr>
</tbody>
</table>
<blockquote>
<p>goods_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>materiel_type_id</td>
<td>是</td>
<td>否</td>
<td>商品关联id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>price</td>
<td>是</td>
<td>否</td>
<td>价格</td>
<td>string</td>
<td>3</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>warehouse</td>
<td>是</td>
<td>否</td>
<td>仓库名称</td>
<td>string</td>
<td>一仓</td>
</tr>
<tr>
<td>warehouse_id</td>
<td>是</td>
<td>否</td>
<td>仓库主键id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>shelf_id</td>
<td>是</td>
<td>否</td>
<td>货架ID</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>location_id</td>
<td>是</td>
<td>否</td>
<td>库位ID</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>package_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>price</td>
<td>是</td>
<td>否</td>
<td>价格</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>package_id</td>
<td>是</td>
<td>否</td>
<td>套餐id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>name</td>
<td>是</td>
<td>否</td>
<td>套餐名称</td>
<td>string</td>
<td>新套餐</td>
</tr>
<tr>
<td>package_content</td>
<td>是</td>
<td>否</td>
<td>套餐名称</td>
<td>array</td>
<td>套餐内容</td>
</tr>
<tr>
<td>allName</td>
<td>是</td>
<td>否</td>
<td>商品全称</td>
<td>string</td>
<td>测试2/型号2(00JvmCY9)</td>
</tr>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>套餐内容ID</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>type_id</td>
<td>是</td>
<td>否</td>
<td>商品ID</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>materiel_class_id</td>
<td>是</td>
<td>否</td>
<td>商品分类id</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>storage_id</td>
<td>是</td>
<td>否</td>
<td>仓库ID</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>storage_manage_id</td>
<td>是</td>
<td>否</td>
<td>库存ID</td>
<td>integer</td>
<td>32</td>
</tr>
<tr>
<td>shelf_id</td>
<td>是</td>
<td>否</td>
<td>货架ID</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>location_id</td>
<td>是</td>
<td>否</td>
<td>库位ID</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-08-25 16:40`:请求参数 goods_info 增加`shelf_id`,`location_id`
</code></pre></blockquote>
<h1 id="-zl-">采购单相关修改(zl)</h1>
<h2 id="-">列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/materiel_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>页面大小</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>当前页</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>repeal_status</td>
<td>是</td>
<td>否</td>
<td>撤销状态：0-未撤销 1-已撤销</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>search_type</td>
<td>是</td>
<td>否</td>
<td>搜索类型</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>status</td>
<td>是</td>
<td>否</td>
<td>状态</td>
<td>integer</td>
<td>0</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
            {
                &quot;id&quot;: 1,    //采购单主键id
                &quot;repeal_status&quot;: 0, //是否撤销;0:否;1:是;
                &quot;purchase_time&quot;: &quot;1970-01-01 08:33:41&quot;, //采购日期
                &quot;supplier_name&quot;: &quot;客户001&quot;,   //供应商名称
                &quot;final_money&quot;: &quot;14803.00&quot;,  //实付金额(修改价格或折扣后金额)
                &#39;out_order_no&#39;: &quot;123&quot;,  //采购单外部单号
                &quot;purchase_no&quot;: &quot;20211129164857755624859&quot;,   //采购内部单号
                &quot;username&quot;: &quot;掌上仓管&quot;, //操作人账号
                &quot;nickname&quot;: &quot;施艳梅&quot;,  //操作人昵称
                &quot;total&quot;: 400,   //采购总数
                &quot;materiel_content&quot;: [
                    {
                        &quot;id&quot;: 1,    //采购单内容主键id
                        &quot;materiel_id&quot;: 1,   //采购单id
                        &quot;unit_price&quot;: &quot;10.50&quot;,  //单价
                        &quot;num&quot;: 100, //数量
                        &quot;rest_num&quot;: 110,//剩余可入库数量
                        &quot;materiel_name&quot;: &quot;牛卫士洗衣凝珠&quot;, //物料名称
                        &quot;type_name&quot;: &quot;香水1&quot;, //物料型号
                        &quot;materiel_no&quot;: &quot;13246578&quot;,  //物料编号
                        &quot;materiel_img&quot;: &quot;&quot;  //物料图
                        &quot;shelf_id&quot;: 1613, //货架ID
                        &quot;location_id&quot;: 1614, //库位id
                        &quot;shelf_name&quot;: &quot;测试货架1&quot;, //货架名称
                        &quot;location_name&quot;: &quot;测试库位2&quot; //库位名称
                    }
                    ......
                ]
            }
        ],
        &quot;total&quot;: 1  //总条数
    }
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-08-25 16:40`:增加`shelf_id`,`location_id`,`shelf_name`,`location_name`返回 
</code></pre></blockquote>
<h2 id="-">详细</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>采购单详细</td>
<td>http</td>
<td>post</td>
<td>api/materiel_detail</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>退货主键id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 10,   //采购单主键id
        &quot;main_id&quot;: 8,
        &quot;repeal_status&quot;: 0, //是否撤销;0:否;1:是;
        &quot;out_order_no&quot;: &quot;123&quot;,  //外部单号
        &quot;proof_image&quot;: &quot;123.png,234.png&quot;,   //凭证
        &quot;user_id&quot;: 1242,    //采购人id
        &quot;delete_flag&quot;: 0,
        &quot;created_at&quot;: &quot;2021-11-26 13:46:48&quot;,    
        &quot;updated_at&quot;: &quot;1970-01-01 08:33:41&quot;,
        &quot;purchase_no&quot;: &quot;20211124144624022843725&quot;,   //采购单内部单号
        &quot;supplier_customer_id&quot;: 5,  //供应商id
        &quot;remark&quot;: &quot;&quot;,   //备注
        &quot;is_draft&quot;: 0,
        &quot;preferential_way&quot;: 0,  //优惠方式;0:无;1:修改价格;2:折扣优惠;
        &quot;tax_rate&quot;: 13, //税率
        &quot;discount&quot;: 0, //折扣
        &quot;final_money&quot;: &quot;14803.00&quot;,  //实付金额(修改价格后或折扣后金额)
        &quot;real_money&quot;: &quot;14803.00&quot;,   //应付金额(修改价格前或折扣优惠前金额)
        &quot;original_money&quot;: &quot;13100.00&quot;,   //原金额(税前应付)
        &#39;fact_money&#39;: &quot;101.00&quot;  //实付金额
        &quot;purchase_time&quot;: &quot;2021-11-24 15:56:23&quot;, //采购日期
        &quot;shipping_method&quot;: 1,   //发货方式：1-自提 2-代发 3-送货
        &quot;transport_type&quot;: 1,    //运输方式：1-空运 2-海运 3-铁路 4-公路
        &quot;logistics_company&quot;: null,  //物流公司
        &quot;logistics_order_no&quot;: null, //物流单号
        &quot;deliver_person&quot;: &quot;客户001&quot;,  //发货人
        &quot;deliver_phone&quot;: &quot;15267902931&quot;, /发货人联系方式/
        &quot;deliver_address&quot;: &quot;安徽省蚌埠市东海大道888&quot;, //发货地址
        &quot;other_charges&quot;: &quot;10.00&quot;,   //其他费用
        &quot;source&quot;: 1, //订单来源（1-安卓 2-ios 3-pc 4-微信小程序 5-抖音小程序）
        &quot;pay_status&quot;: 0,    //付款状态：0-待付款 1-部分付款 2-全部付款
        &quot;in_storage_status&quot;: 0, //入库状态:0:待入库;1:部分入库;2:全部入库;
        &quot;supplier_name&quot;: &quot;客户001&quot;,   //供应商名称
        &quot;nickname&quot;: &quot;施艳梅&quot;,  //采购人昵称
        &quot;username&quot;: &quot;掌上仓管&quot;, //采购人账号
        &quot;materiel_content&quot;: [
            {
                &quot;id&quot;: 25,   //采购单内容主键id
                &quot;materiel_id&quot;: 10,  //采购单主键id
                &quot;unit_price&quot;: &quot;10.50&quot;,  //单价
                &quot;num&quot;: 100, //采购数量
                &quot;in_num&quot;: 50,   //已入库数量
                &quot;is_in&quot;: 1,     //是否入库;0:否;1:是;
                &quot;in_storage_num&quot;: 800,  //当前物料实时库存数
                &quot;materiel_name&quot;: &quot;牛卫士洗衣凝珠&quot;, //物料名
                &quot;type_name&quot;: &quot;香水1&quot;, //物料型号
                &quot;materiel_no&quot;: &quot;13246578&quot;,  //物料编号
                &quot;materiel_img&quot;: &quot;&quot;,  //物料图
                &quot;storage_name&quot;: &quot;B1-10&quot;     //入库仓库
                &quot;storage_address&quot;: &quot;1&quot;,
                &quot;is_use_serial&quot;: 1,//是否开启序列号：1是，0否
                &quot;shelf_id&quot;: 1613, //货架ID
                &quot;location_id&quot;: 1614, //库位id
                &quot;shelf_name&quot;: &quot;测试货架1&quot;, //货架名称
                &quot;location_name&quot;: &quot;测试库位2&quot; //库位名称
                &quot;serial_number_list&quot;: [//采购单序列号
                    &quot;323245324&quot;,
                    &quot;4234214&quot;,
                    &quot;432234&quot;
                ]
            },
            ......
        ]
    }
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-08-25 16:40`:增加`shelf_id`,`location_id`,`shelf_name`,`location_name`、`serial_number_list`、`is_use_serial`返回 
</code></pre></blockquote>
<h2 id="-">创建采购单</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>采购-新建采购单</td>
<td>http</td>
<td>post</td>
<td>api/add_materiel</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>materiel_content</td>
<td>是</td>
<td>否</td>
<td>销售主键id</td>
<td>json数组</td>
<td></td>
</tr>
<tr>
<td>supplier_customer_id</td>
<td>是</td>
<td>否</td>
<td>供应商id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>t4est</td>
</tr>
<tr>
<td>purchase_time</td>
<td>是</td>
<td>否</td>
<td>采购日期</td>
<td>string</td>
<td>2021-11-23 15:53:26</td>
</tr>
<tr>
<td>tax_rate</td>
<td>是</td>
<td>否</td>
<td>税率</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>preferential_way</td>
<td>是</td>
<td>否</td>
<td>优惠方式;0:无;1:修改价格;2:折扣优惠;</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>preferential_money</td>
<td>是</td>
<td>否</td>
<td>优惠方式值为非0时,对应的修改价格和折扣优惠后金额</td>
<td>float</td>
<td>0</td>
</tr>
<tr>
<td>out_order_no</td>
<td>否</td>
<td>否</td>
<td>外部单号</td>
<td>string</td>
<td>1234561321</td>
</tr>
<tr>
<td>proof_image</td>
<td>否</td>
<td>否</td>
<td>采购凭证图</td>
<td>string</td>
<td>多图以逗号拼接的形式入参</td>
</tr>
<tr>
<td>source</td>
<td>是</td>
<td>否</td>
<td>订单来源(1-安卓 2-ios 3-pc 4-微信小程序 5-抖音小程序)</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注</p>
<pre><code>`preferential_way`为1时，`preferential_money`传入修改后的价格；
`preferential_way`为2时，`preferential_money`传入折扣比例；
</code></pre></blockquote>
<blockquote>
<p><code>materiel_content</code>参数示例</p>
</blockquote>
<pre><code>[{&quot;type_id&quot;:35069,&quot;materiel_name&quot;:&quot;测试1&quot;,&quot;type_name&quot;:&quot;型号1&quot;,&quot;materiel_img&quot;:&quot;&quot;,&quot;materiel_no&quot;:&quot;ol1Tpi3Y&quot;,&quot;storage_id&quot;:1872,&quot;unit_price&quot;:&quot;1&quot;,&quot;num&quot;:&quot;1&quot;,&quot;shelf_id&quot;:1613,&quot;location_id&quot;:1614}]
</code></pre><blockquote>
<p><code>materiel_content</code>参数说明</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>type_id</td>
<td>是</td>
<td>否</td>
<td>物料id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>materiel_name</td>
<td>是</td>
<td>否</td>
<td>物料名称</td>
<td>string</td>
<td>保温箱</td>
</tr>
<tr>
<td>type_name</td>
<td>是</td>
<td>否</td>
<td>物料型号</td>
<td>string</td>
<td>保温箱</td>
</tr>
<tr>
<td>materiel_img</td>
<td>否</td>
<td>否</td>
<td>物料图</td>
<td>string</td>
<td>xxx.png</td>
</tr>
<tr>
<td>materiel_no</td>
<td>否</td>
<td>否</td>
<td>物料型号</td>
<td>string</td>
<td>1345678</td>
</tr>
<tr>
<td>storage_id</td>
<td>是</td>
<td>否</td>
<td>入库目标仓库id</td>
<td>integer</td>
<td>7</td>
</tr>
<tr>
<td>unit_price</td>
<td>是</td>
<td>否</td>
<td>单价</td>
<td>float</td>
<td>10.5</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>采购数量;最小为1</td>
<td>integer</td>
<td>1000</td>
</tr>
<tr>
<td>shelf_id</td>
<td>是</td>
<td>否</td>
<td>货架ID</td>
<td>integer</td>
<td>1000</td>
</tr>
<tr>
<td>location_id</td>
<td>是</td>
<td>否</td>
<td>库位id</td>
<td>integer</td>
<td>1000</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 12
    }
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-08-25 16:40`:请求参数 增加`shelf_id`,`location_id`
</code></pre></blockquote>
<h2 id="-">修改采购</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>采购-新建采购单</td>
<td>http</td>
<td>post</td>
<td>api/edit_materiel</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>采购单id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>supplier_customer_id</td>
<td>是</td>
<td>否</td>
<td>供应商id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>materiel_content</td>
<td>是</td>
<td>否</td>
<td>采购单内容</td>
<td>json数组</td>
<td></td>
</tr>
<tr>
<td>supplier_customer_id</td>
<td>是</td>
<td>否</td>
<td>供应商id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>t4est</td>
</tr>
<tr>
<td>purchase_time</td>
<td>是</td>
<td>否</td>
<td>采购日期</td>
<td>string</td>
<td>2021-11-23 15:53:26</td>
</tr>
<tr>
<td>tax_rate</td>
<td>是</td>
<td>否</td>
<td>税率</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>fact_money</td>
<td>否</td>
<td>否</td>
<td>实付金额</td>
<td>float</td>
<td>0</td>
</tr>
<tr>
<td>preferential_way</td>
<td>是</td>
<td>否</td>
<td>优惠方式;0:无;1:修改价格;2:折扣优惠;</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>preferential_money</td>
<td>是</td>
<td>否</td>
<td>优惠方式值为非0时,对应的修改价格和折扣优惠后金额</td>
<td>float</td>
<td>0</td>
</tr>
<tr>
<td>out_order_no</td>
<td>否</td>
<td>否</td>
<td>外部单号</td>
<td>string</td>
<td>1234561321</td>
</tr>
<tr>
<td>proof_image</td>
<td>否</td>
<td>否</td>
<td>采购凭证图</td>
<td>string</td>
<td>多图以逗号拼接的形式入参</td>
</tr>
<tr>
<td>shipping_method</td>
<td>否</td>
<td>否</td>
<td>外部单号</td>
<td>int</td>
<td>发货方式：1-自提 2-代发 3-送货</td>
</tr>
<tr>
<td>transport_type</td>
<td>否</td>
<td>否</td>
<td>外部单号</td>
<td>int</td>
<td>运输方式：1-空运 2-海运 3-铁路 4-公路</td>
</tr>
<tr>
<td>logistics_company</td>
<td>否</td>
<td>否</td>
<td>物流公司</td>
<td>string</td>
<td>快快递</td>
</tr>
<tr>
<td>logistics_order_no</td>
<td>否</td>
<td>否</td>
<td>物流单号</td>
<td>string</td>
<td>1234561321</td>
</tr>
<tr>
<td>deliver_person</td>
<td>否</td>
<td>否</td>
<td>发货人</td>
<td>string</td>
<td>biubiu</td>
</tr>
<tr>
<td>deliver_phone</td>
<td>否</td>
<td>否</td>
<td>发货人联系方式</td>
<td>string</td>
<td>15267902931</td>
</tr>
<tr>
<td>deliver_address</td>
<td>否</td>
<td>否</td>
<td>发货地址</td>
<td>string</td>
<td>安徽省蚌埠市东海大道888</td>
</tr>
<tr>
<td>source</td>
<td>否</td>
<td>否</td>
<td>订单来源</td>
<td>string</td>
<td>淘宝</td>
</tr>
<tr>
<td>pay_status</td>
<td>否</td>
<td>否</td>
<td>付款状态：0-待付款 1-部分付款 2-全部付款</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>in_storage_status</td>
<td>否</td>
<td>否</td>
<td>入库状态:0:待入库;1:部分入库;2:全部入库;</td>
<td>integer</td>
<td>2</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>materiel_content</code>参数示例</p>
</blockquote>
<pre><code>[{&quot;type_id&quot;:35069,&quot;materiel_name&quot;:&quot;测试1&quot;,&quot;type_name&quot;:&quot;型号1&quot;,&quot;materiel_img&quot;:&quot;&quot;,&quot;materiel_no&quot;:&quot;ol1Tpi3Y&quot;,&quot;storage_id&quot;:1872,&quot;unit_price&quot;:&quot;1&quot;,&quot;num&quot;:&quot;1&quot;,&quot;shelf_id&quot;:1613,&quot;location_id&quot;:1614}]
</code></pre><blockquote>
<p><code>materiel_content</code>参数说明</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>type_id</td>
<td>是</td>
<td>否</td>
<td>物料id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>materiel_name</td>
<td>是</td>
<td>否</td>
<td>物料名称</td>
<td>string</td>
<td>保温箱</td>
</tr>
<tr>
<td>type_name</td>
<td>是</td>
<td>否</td>
<td>物料型号</td>
<td>string</td>
<td>保温箱</td>
</tr>
<tr>
<td>materiel_img</td>
<td>否</td>
<td>否</td>
<td>物料图</td>
<td>string</td>
<td>xxx.png</td>
</tr>
<tr>
<td>materiel_no</td>
<td>否</td>
<td>否</td>
<td>物料型号</td>
<td>string</td>
<td>1345678</td>
</tr>
<tr>
<td>storage_id</td>
<td>是</td>
<td>否</td>
<td>入库目标仓库id</td>
<td>integer</td>
<td>7</td>
</tr>
<tr>
<td>unit_price</td>
<td>是</td>
<td>否</td>
<td>单价</td>
<td>float</td>
<td>10.5</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>采购数量;最小为1</td>
<td>integer</td>
<td>1000</td>
</tr>
<tr>
<td>shelf_id</td>
<td>是</td>
<td>否</td>
<td>货架ID</td>
<td>integer</td>
<td>1000</td>
</tr>
<tr>
<td>location_id</td>
<td>是</td>
<td>否</td>
<td>库位id</td>
<td>integer</td>
<td>1000</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-08-25 16:40`:请求参数 增加`shelf_id`,`location_id`
</code></pre></blockquote>
<h2 id="-">入库</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>采购单-入库</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/materiel_in_storage</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>content</td>
<td>是</td>
<td>否</td>
<td>采购单id</td>
<td>json数组</td>
<td>1</td>
</tr>
<tr>
<td>status</td>
<td>是</td>
<td>否</td>
<td>入库状态:2-全部 1-部分</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>in_storage_time</td>
<td>是</td>
<td>否</td>
<td>入库时间</td>
<td>date</td>
<td>2021-11-12 13:25:20</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>备注</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>content</code>示例</p>
<pre><code>[{&quot;materiel_content_id&quot;:22,&quot;storage_id&quot;:1872,&quot;num&quot;:1,&quot;materiel_id&quot;:&quot;17&quot;,&quot;price&quot;:&quot;1&quot;,&quot;remark&quot;:&quot;&quot;,&quot;shelf_id&quot;:1613,&quot;location_id&quot;:1614,&quot;serial_no&quot;:&quot;asf45636,dgf68587,tged543434&quot;}]
</code></pre></blockquote>
<blockquote>
<p><code>content</code>说明</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>materiel_content_id</td>
<td>是</td>
<td>否</td>
<td>采购单内容主键id</td>
<td>json数组</td>
<td>1</td>
</tr>
<tr>
<td>storage_id</td>
<td>是</td>
<td>否</td>
<td>入库目标仓库id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>price</td>
<td>是</td>
<td>否</td>
<td>采购商品单价</td>
<td>float</td>
<td>10.1</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>入库数量</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>materiel_id</td>
<td>是</td>
<td>否</td>
<td>采购单主键id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>shelf_id</td>
<td>是</td>
<td>否</td>
<td>货架ID</td>
<td>integer</td>
<td>1000</td>
</tr>
<tr>
<td>location_id</td>
<td>是</td>
<td>否</td>
<td>库位id</td>
<td>integer</td>
<td>1000</td>
</tr>
<tr>
<td>serial_no</td>
<td>是</td>
<td>否</td>
<td>序列号（多个用英文逗号分隔）</td>
<td>string</td>
<td>adfa35234,aggrg3324,fg353</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>备注</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注</p>
<pre><code>全部入库时，实际入库数量以数据库中存储的剩余可以操作入库数量为准，参数`num`可默认为0；
部分入库时，实际入库数量以用户手动输入的结果为准，参数`num`为用户所填写的入库物料数；
`price`可以进行手动调整后入库
</code></pre><p>变动内容</p>
<pre><code>`2022-08-25 16:40`:请求参数 增加`shelf_id`,`location_id`,`serial_no`
</code></pre></blockquote>
<h1 id="-zl-">直接入库-批量(zl)</h1>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>直接入库</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/direct_in_storage_several</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>storage_id</td>
<td>是</td>
<td>否</td>
<td>入库目标仓库id</td>
<td>integer</td>
<td>107</td>
</tr>
<tr>
<td>storage_name</td>
<td>是</td>
<td>否</td>
<td>仓库名</td>
<td>string</td>
<td>B1-10</td>
</tr>
<tr>
<td>status</td>
<td>是</td>
<td>否</td>
<td>是否设置低库存预警数;0:否;1:是;</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>备注</td>
</tr>
<tr>
<td>alert_num</td>
<td>是</td>
<td>否</td>
<td>低库存预警数</td>
<td>integer</td>
<td>100</td>
</tr>
<tr>
<td>goods_info</td>
<td>是</td>
<td>否</td>
<td>商品信息</td>
<td>array</td>
<td>[{&quot;materiel_name&quot;:&quot;测试1&quot;,&quot;type_name&quot;:&quot;型号1&quot;,&quot;num&quot;:1,&quot;serial_no&quot;:&quot;sj0001&quot;},{&quot;materiel_name&quot;:&quot;测试2&quot;,&quot;type_name&quot;:&quot;型号2&quot;,&quot;num&quot;:2,&quot;serial_no&quot;:&quot;sj0002&quot;}]</td>
</tr>
<tr>
<td>location_id</td>
<td>否</td>
<td>否</td>
<td>货架ID</td>
<td>integer</td>
<td>100</td>
</tr>
<tr>
<td>goods_info</td>
<td>否</td>
<td>否</td>
<td>库位id</td>
<td>integer</td>
<td>100</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><h1 id="-">快速出库</h1>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>快速出库</td>
<td>http</td>
<td>post</td>
<td>api/fast_out_storage</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>sell_id</td>
<td>否</td>
<td>否</td>
<td>单据id</td>
<td>integer</td>
<td>15</td>
</tr>
<tr>
<td>batch_no</td>
<td>是</td>
<td>否</td>
<td>批次号(后台识别商品或套餐)</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>form_type</td>
<td>否</td>
<td>否</td>
<td>单据类型(默认为销售单)0:销售单;1:报溢报损;2:退货;</td>
<td>integer</td>
<td>15</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><blockquote>
<p>变更内容</p>
<pre><code>`2022-09-15 21:28`:增加请求参数`form_type`
</code></pre></blockquote>
<h1 id="-zl-">销售单相关修改(zl)</h1>
<h2 id="-">列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/sell_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>页面大小</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>当前页</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>repeal_status</td>
<td>是</td>
<td>否</td>
<td>撤销状态：0-未撤销 1-已撤销</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>search_type</td>
<td>是</td>
<td>否</td>
<td>搜索类型</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>status</td>
<td>是</td>
<td>否</td>
<td>状态</td>
<td>integer</td>
<td>0</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1, //当前页
        &quot;data&quot;: [
            {
                &quot;id&quot;: 4,    //销售单主键id
                &quot;main_id&quot;: 7,    //
                &quot;user_id&quot;: 7,    //
                &quot;customer_name&quot;: &quot;张三&quot;,    //客户姓名
                &quot;consignee&quot;: &quot;&quot;,    //收货人
                &quot;phone&quot;: &quot;&quot;,    //联系电话
                &quot;address&quot;: &quot;&quot;,    //收货地址
                &quot;proof_image&quot;: null,    //凭证图片(多图逗号分隔)
                &quot;discount&quot;: null,    //折扣 ：百分比
                                &quot;discount&quot;: 80,         //折扣
                &quot;tax_rate&quot;: null,    // 税率 ：百分比
                                &quot;tax_rate&quot;: 10,    //税率
                &quot;final_money&quot;: &quot;4.60&quot;,    //实际应收金额（即折扣或抹零后价格不含运费）
                &quot;money&quot;: &quot;4.60&quot;,    //货款金额（纯商品金额）
                &quot;real_money&quot;: &quot;0.00&quot;,    //实收金额（实际入账）
                &quot;is_zero_suppression&quot;: 0,    //是否抹零：0-否 1-是
                &quot;other_charges&quot;: &quot;0.00&quot;,    //其他费用
                &quot;remark&quot;: null,    //备注
                &quot;out_order_no&quot;: &quot;&quot;,    //外部单号
                &quot;order_no&quot;: &quot;S71648103178833&quot;,    //订单号-内部单号
                &quot;sell_date&quot;: &quot;2021-11-02 13:22:23&quot;,    //销售时间
                &quot;logistics_company&quot;: &quot;&quot;,    //物流公司
                &quot;logistics_order_no&quot;: &quot;&quot;,    //物流单号
                &quot;out_status&quot;: 0,    //出库状态：0-待出库 1-部分出库 2-全部出库
                &quot;pay_status&quot;: 0,    //付款状态：0-待付款 1-部分付款 2-全部付款
                &quot;order_time&quot;: null,    //下单时间
                &quot;deliver_time&quot;: null,    //发货时间
                &quot;deliver_person&quot;: &quot;&quot;,    //发货人
                &quot;deliver_phone&quot;: &quot;&quot;,    //发货人联系方式
                &quot;deliver_addr&quot;: &quot;&quot;,    //发货地址
                &quot;repeal_status&quot;: 0,    //撤销状态：0-未撤销 1-已撤销
                &quot;deliver_goods_type&quot;: 0,    //发货方式：1-自提 2-代发 3-送货
                &quot;transport_type&quot;: 0,    //运输方式：1-空运 2-海运 3-铁路 4-公路
                &quot;is_draft&quot;: 0,    //是否草稿：1-是 0-否
                &quot;created_at&quot;: &quot;2022-03-24 14:26:18&quot;,
                &quot;updated_at&quot;: &quot;2022-03-24 14:26:18&quot;,
                &quot;username&quot;: &quot;15505523456&quot;,    //操作人账号
                &quot;nickname&quot;: &quot;用户昵称1&quot;,    //操作人昵称
                                //销售单商品信息部分
                &quot;materiel_info&quot;: [
                    {
                        &quot;sell_goods_id&quot;: 13,//销售单内商品id
                        &quot;name&quot;: &quot;艾纯深海盐肌补水泡泡膜&quot;,    //商品名
                        &quot;type_name&quot;: &quot;泡泡&quot;,    //归革命
                        &quot;price&quot;: &quot;2.30&quot;,    //售价
                        &quot;cost_price&quot;: &quot;0.00&quot;,    //商品成本
                        &quot;num&quot;: 2,    //商品数量
                        &quot;materiel_no&quot;: &quot;&quot;,    //商品编号
                        &quot;image&quot;: &quot;&quot;,    //商品图片
                        &quot;warehouse&quot;: &quot;B2-6栋&quot;,    //仓库名称
                        &quot;warehouse_id&quot;: 4,    //
                        &quot;piece&quot;: 0,    //件数
                        &quot;sell_id&quot;: 4.    //销售单主键id
                        &quot;storage_manage_id&quot;: 532,   库存id
                        &quot;in_storage_num&quot;: null //库存数

                         &quot;shelf_id&quot;: 1613,           货架ID
                        &quot;location_id&quot;: 1614,        库位ID
                        &quot;shelf_name&quot;: &quot;测试货架1&quot;,   货架名称
                        &quot;location_name&quot;: &quot;测试库位2&quot; 库位名称
                    }
                ],
                                //销售单套餐信息部分
                &quot;package_info&quot;: [
                    {
                        &quot;sell_package_id&quot;: 4,    //销售单套餐id
                        &quot;package_id&quot;: 52,    //套餐id
                        &quot;package_name&quot;: &quot;老蓝，5L保温箱+温度显示+1蓝冰+6冰袋&quot;,    //套餐名
                        &quot;price&quot;: &quot;2.30&quot;,    //售价
                        &quot;total_cost&quot;: &quot;0.00&quot;,    //套餐总成本
                        &quot;sell_id&quot;: 4,    //销售单id
                        &quot;num&quot;: 2,    //套餐数量
                        &quot;out_num&quot;: 0,    //已出库套餐数量
                                                //销售单套餐内容部分
                        &quot;package_content&quot;: [
                            {
                                &quot;id&quot;: 50,   //销售单内套餐商品id
                                &quot;num&quot;: 1,   //数量
                                &quot;materiel_type_id&quot;: 13315,  //商品id
                                &quot;package_detail_id&quot;: 43,    //
                                &quot;materiel_name&quot;: &quot;电影&quot;,  //商品名
                                &quot;type_name&quot;: &quot;RL&quot;,  //规格名
                                &quot;materiel_no&quot;: &quot;KK3IiInU&quot;,  //商品编号
                                &quot;materiel_img&quot;: &quot;/uploads/2022/06/21/wHiNMOfp3AI2J2NZm2jcaBAn65rBaSskbRgwuH6l.jpg&quot;, //商品图
                                &quot;s_class_name&quot;: &quot;5-2&quot;,  //二级分类名
                                &quot;s_class_no&quot;: &quot;dbl2&quot;,   //二级分类编号
                                &quot;f_class_name&quot;: &quot;5&quot;,    //一级分类名
                                &quot;f_class_no&quot;: &quot;mAyG&quot;,   //二级分类编号
                                &quot;storage_name&quot;: &quot;6&quot;,    //仓库名
                                &quot;in_storage_num&quot;: 10137 //库存数量

                                &quot;shelf_id&quot;: 1613,           货架ID
                                &quot;location_id&quot;: 1614,        库位ID
                                &quot;shelf_name&quot;: &quot;测试货架1&quot;,   货架名称
                                &quot;location_name&quot;: &quot;测试库位2&quot; 库位名称
                            }
                        ]
                    }
                ],
               &quot;driver&quot;:  {
                    &quot;id&quot;: 5,    //司机主键id
                    &quot;plate_number&quot;: &quot;皖A*98098&quot;,    //车牌   
                    &quot;name&quot;: &quot;陈&quot;,                   //司机姓名
                    &quot;phone&quot;: &quot;18966558879&quot;,         //提货司机电话
                    &quot;logistics_company&quot;: &quot;&quot;,        //物流公司
                    &quot;remark&quot;: &quot;&quot;,                   //备注
                    &quot;plate_image&quot;: &quot;k.png&quot;,         //车牌照片
                    &quot;id_card_image&quot;: &quot;ks.png&quot;,      //身份证照片
                    &quot;driving_licence&quot;: &quot;kks.png&quot;,   //驾驶证照片
                    &quot;sell_id&quot;: 8,                   //销售单主键id
                }
            }
        ],
                ......
        &quot;total&quot;: 3 //总条数
    }
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-08-25 16:40`:增加`shelf_id`,`location_id`,`shelf_name`,`location_name`返回 
</code></pre></blockquote>
<h2 id="-">已有快递信息的销售单列表</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>已有快递信息的销售单列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/sell_express_info</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>页面大小</td>
<td>integer</td>
<td>15</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>页码</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>code</td>
<td>否</td>
<td>否</td>
<td>快递号</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
            {
                &quot;logistics_order_no&quot;: &quot;YT6576474579981&quot;,    //快递号
                &quot;logistics_company&quot;: &quot;&quot;    //快递公司名
            }
        ],
        .......
        &quot;total&quot;: 1
    }
}
</code></pre><h2 id="-">详细</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>销售单详细</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/sell_detail</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>销售单主键id</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;id&quot;: 4,    //销售单主键id
                &quot;main_id&quot;: 7,    //
                &quot;user_id&quot;: 7,    //
                &quot;customer_name&quot;: &quot;张三&quot;,    //客户姓名
                &quot;consignee&quot;: &quot;&quot;,    //收货人
                &quot;phone&quot;: &quot;&quot;,    //联系电话
                &quot;address&quot;: &quot;&quot;,    //收货地址
                &quot;proof_image&quot;: null,    //凭证图片(多图逗号分隔)
                &quot;discount&quot;: null,    //折扣 ：百分比
                &quot;discount&quot;: 80,         //折扣
                &quot;tax_rate&quot;: null,    // 税率 ：百分比
                &quot;tax_rate&quot;: 10,    //税率
                &quot;final_money&quot;: &quot;4.60&quot;,    //实际应收金额（即折扣或抹零后价格不含运费）
                &quot;money&quot;: &quot;4.60&quot;,    //货款金额（纯商品金额）
                &quot;real_money&quot;: &quot;0.00&quot;,    //实收金额（实际入账）
                &quot;is_zero_suppression&quot;: 0,    //是否抹零：0-否 1-是
                &quot;other_charges&quot;: &quot;0.00&quot;,    //其他费用
                &quot;remark&quot;: null,    //备注
                &quot;total_piece&quot;:0, //总件数
                &quot;out_order_no&quot;: &quot;&quot;,    //外部单号
                &quot;order_no&quot;: &quot;S71648103178833&quot;,    //订单号-内部单号
                &quot;sell_date&quot;: &quot;2021-11-02 13:22:23&quot;,    //销售时间
                &quot;logistics_company&quot;: &quot;&quot;,    //物流公司
                &quot;logistics_order_no&quot;: &quot;&quot;,    //物流单号
                &quot;out_status&quot;: 0,    //出库状态：0-待出库 1-部分出库 2-全部出库
                &quot;pay_status&quot;: 0,    //付款状态：0-待付款 1-部分付款 2-全部付款
                &quot;order_time&quot;: null,    //下单时间
                &quot;deliver_time&quot;: null,    //发货时间
                &quot;deliver_person&quot;: &quot;&quot;,    //发货人
                &quot;deliver_phone&quot;: &quot;&quot;,    //发货人联系方式
                &quot;deliver_addr&quot;: &quot;&quot;,    //发货地址
                &quot;repeal_status&quot;: 0,    //撤销状态：0-未撤销 1-已撤销
                &quot;deliver_goods_type&quot;: 0,    //发货方式：1-自提 2-代发 3-送货
                &quot;transport_type&quot;: 0,    //运输方式：1-空运 2-海运 3-铁路 4-公路
                &quot;is_draft&quot;: 0,    //是否草稿：1-是 0-否
                &quot;created_at&quot;: &quot;2022-03-24 14:26:18&quot;,
                &quot;updated_at&quot;: &quot;2022-03-24 14:26:18&quot;,
                &quot;username&quot;: &quot;15505523456&quot;,    //操作人账号
                &quot;nickname&quot;: &quot;用户昵称1&quot;,    //操作人昵称
                //销售单商品信息部分
                &quot;materiel_info&quot;: [
                    {
                        &quot;sell_goods_id&quot;: 1, 销售单商品id
                        &quot;name&quot;: &quot;艾纯深海盐肌补水泡泡膜&quot;,    //商品名
                        &quot;type_name&quot;: &quot;泡泡&quot;,    //归革命
                        &quot;price&quot;: &quot;2.30&quot;,    //售价
                        &quot;cost_price&quot;: &quot;0.00&quot;,    //商品成本
                        &quot;num&quot;: 2,    //商品数量
                        &quot;out_num&quot;: 2,    //已出库商品数量
                        &quot;materiel_no&quot;: &quot;&quot;,    //商品编号
                        &quot;image&quot;: &quot;&quot;,    //商品图片
                        &quot;warehouse&quot;: &quot;B2-6栋&quot;,    //仓库名称
                        &quot;warehouse_id&quot;: 4,    //仓库id
                        &quot;piece&quot;: 0,    //件数
                        &quot;sell_id&quot;: 4.    //销售单主键id
                        &quot;storage_manage_id&quot;: 532, 库存id
                        &quot;materiel_class_id&quot;: 7,//商品二级分类id
                        &quot;in_storage_num&quot;: null //库存数

                        &quot;shelf_id&quot;: 1613,           货架ID
                        &quot;location_id&quot;: 1614,        库位ID
                        &quot;shelf_name&quot;: &quot;测试货架1&quot;,   货架名称
                        &quot;location_name&quot;: &quot;测试库位2&quot; 库位名称

                        &quot;goods_batch_info&quot;: [
                            {
                                &quot;id&quot;: 5,    
                                &quot;storage_batch_id&quot;: 45, //库存批次id
                                &quot;batch_no&quot;: &quot;zs202206281059041095&quot;, //商品批次编号
                                &quot;storage_manage_id&quot;: 10053, //库存id
                                &quot;sell_goods_detail_id&quot;: 296,    //销售单内商品主键id(非商品主键id)
                                &quot;sell_id&quot;: 226, //销售单id
                                &quot;main_id&quot;: 4635,    //
                                &quot;num&quot;: 2,   //数量
                                &quot;rest_num&quot;: 0,  //剩余数量
                                &quot;created_at&quot;: &quot;2022-06-27 17:14:30&quot;,
                                &quot;updated_at&quot;: &quot;2022-06-28 20:04:49&quot;
                            }
                        ],
                    }
                ],
                //销售单套餐信息部分
                &quot;package_info&quot;: [
                    {
                        &quot;id&quot;: 4,    //销售单套餐id
                        &quot;sell_package_id&quot;: 1,  //销售单套餐id
                        &quot;package_id&quot;: 52,    //套餐id
                        &quot;package_name&quot;: &quot;老蓝，5L保温箱+温度显示+1蓝冰+6冰袋&quot;,    //套餐名
                        &quot;price&quot;: &quot;2.30&quot;,    //售价
                        &quot;total_cost&quot;: &quot;0.00&quot;,    //套餐总成本
                        &quot;sell_id&quot;: 4,    //销售单id
                        &quot;num&quot;: 2,    //套餐数量
                        &quot;out_num&quot;: 0,    //已出库套餐数量
                        &quot;piece&quot;: 0,    //件数
                        &quot;package_no&quot;: &quot;zs-p202206181848318757&quot;, //套餐编号
                        //销售单套餐内容部分
                        &quot;package_content&quot;: [
                            {
                                &quot;id&quot;: 16,    // 销售单套餐内容id
                                &quot;sell_package_content_id&quot;: 1,  //销售单套餐内容id（
                                &quot;package_detail_id&quot;: 4,    ///销售单套餐id
                                &quot;materiel_name&quot;: &quot;保温箱5L&quot;,    //商品名
                                &quot;materiel_type_id&quot;: 13304,  //商品id
                                &quot;type_name&quot;: &quot;5L&quot;,    //型号
                                &quot;materiel_no&quot;: &quot;&quot;,    //商品编号
                                &quot;materiel_img&quot;: &quot;&quot;,    //商品图
                                &quot;s_class_name&quot;: &quot;保温箱&quot;,    //二级分类名
                                &quot;s_class_no&quot;: &quot;&quot;,    //二级分类编号
                                &quot;f_class_name&quot;: &quot;保温箱类&quot;,    //一级分类名
                                &quot;f_class_no&quot;: &quot;&quot;,    //一级分类编号
                                &quot;storage_name&quot;: &quot;B2-6&quot;,    //仓库地址
                                &quot;in_storage_num&quot;: 0,    //库存数
                                &quot;num&quot;: 0    //套餐内商品数量
                                &quot;total_num&quot;: 10000， //总数(套餐数量 * 套餐内商品数量)

                                &quot;shelf_id&quot;: 1613,           货架ID
                                &quot;location_id&quot;: 1614,        库位ID
                                &quot;shelf_name&quot;: &quot;测试货架1&quot;,   货架名称
                                &quot;location_name&quot;: &quot;测试库位2&quot; 库位名称

                                &quot;package_batch_info&quot;: [
                                    {
                                        &quot;id&quot;: 2,
                                        &quot;sell_package_content_id&quot;: 42,  //销售单套餐内商品id
                                        &quot;storage_manage_id&quot;: 10031, //库存id
                                        &quot;storage_batch_id&quot;: 20, //库存批次id
                                        &quot;sell_id&quot;: 188, //
                                        &quot;main_id&quot;: 4635,    //
                                        &quot;num&quot;: 100, //数量
                                        &quot;rest_num&quot;: 0,  //剩余数量
                                        &quot;batch_no&quot;: &quot;zs202206281059041095&quot;, //商品批次编号
                                        &quot;created_at&quot;: &quot;2022-06-18 16:31:04&quot;,
                                        &quot;updated_at&quot;: &quot;2022-06-23 18:25:50&quot;
                                    }
                                ]
                            }
                        ]
                    }
                ],
               &quot;driver&quot;:  {
                    &quot;id&quot;: 5,    //司机主键id
                    &quot;plate_number&quot;: &quot;皖A*98098&quot;,    //车牌   
                    &quot;name&quot;: &quot;陈&quot;,                   //司机姓名
                    &quot;phone&quot;: &quot;18966558879&quot;,         //提货司机电话
                    &quot;logistics_company&quot;: &quot;&quot;,        //物流公司
                    &quot;remark&quot;: &quot;&quot;,                   //备注
                    &quot;plate_image&quot;: &quot;k.png&quot;,         //车牌照片
                    &quot;id_card_image&quot;: &quot;ks.png&quot;,      //身份证照片
                    &quot;driving_licence&quot;: &quot;kks.png&quot;,   //驾驶证照片
                    &quot;sell_id&quot;: 8,                   //销售单主键id
                }
        }
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-08-25 16:40`:增加`shelf_id`,`location_id`,`shelf_name`,`location_name`返回 
</code></pre></blockquote>
<h2 id="-">添加</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>添加销售单</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/sell_add</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>customer_name</td>
<td>是</td>
<td>否</td>
<td>客户姓名</td>
<td>string</td>
<td>杨总</td>
</tr>
<tr>
<td>goods_info</td>
<td>否</td>
<td>否</td>
<td>商品信息</td>
<td>array</td>
<td>[{&quot;materiel_type_id&quot;:35069,&quot;name&quot;:&quot;测试1&quot;,&quot;type_name&quot;:&quot;型号1&quot;,&quot;materiel_no&quot;:&quot;ol1Tpi3Y&quot;,&quot;price&quot;:&quot;10&quot;,&quot;num&quot;:&quot;100&quot;,&quot;image&quot;:&quot;&quot;,&quot;warehouse&quot;:&quot;shop1&quot;,&quot;warehouse_id&quot;:1872,&quot;shelf_id&quot;:1613,&quot;location_id&quot;:1614}]</td>
</tr>
<tr>
<td>package_info</td>
<td>否</td>
<td>否</td>
<td>套餐信息</td>
<td>array</td>
<td>[{&quot;price&quot;:&quot;1&quot;,&quot;num&quot;:&quot;2&quot;,&quot;package_id&quot;:511,&quot;name&quot;:&quot;新套餐2&quot;,&quot;package_content&quot;:[{&quot;allName&quot;:&quot;测试1/型号1(ol1Tpi3Y)&quot;,&quot;id&quot;:362,&quot;materiel_type_id&quot;:35069,&quot;num&quot;:&quot;5&quot;,&quot;materiel_class_id&quot;:10367,&quot;storage_id&quot;:1872,&quot;storage_manage_id&quot;:29,&quot;shelf_id&quot;:1613,&quot;location_id&quot;:1614},{&quot;allName&quot;:&quot;测试2/型号2(00JvmCY9)&quot;,&quot;id&quot;:363,&quot;materiel_type_id&quot;:35070,&quot;num&quot;:&quot;50&quot;,&quot;materiel_class_id&quot;:10367,&quot;storage_id&quot;:1872,&quot;storage_manage_id&quot;:32,&quot;shelf_id&quot;:1613,&quot;location_id&quot;:1614}]}]</td>
</tr>
<tr>
<td>discount</td>
<td>否</td>
<td>否</td>
<td>折扣 ：百分比</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>tax_rate</td>
<td>否</td>
<td>否</td>
<td>税率 ：百分比</td>
<td>integer</td>
<td>13</td>
</tr>
<tr>
<td>is_zero_suppression</td>
<td>是</td>
<td>否</td>
<td>是否抹零：0-否 1-是</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>final_money</td>
<td>否</td>
<td>否</td>
<td>实际应收金额（即折扣或抹零后价格）如果是抹零此参数必传</td>
<td>string</td>
<td>10.99</td>
</tr>
<tr>
<td>deliver_goods_type</td>
<td>否</td>
<td>否</td>
<td>发货方式：1-自提 2-代发 3-送货</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>transport_type</td>
<td>否</td>
<td>否</td>
<td>运输方式：1-空运 2-海运 3-铁路 4-公路</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>consignee</td>
<td>否</td>
<td>否</td>
<td>收货人</td>
<td>string</td>
<td>孙先生</td>
</tr>
<tr>
<td>phone</td>
<td>否</td>
<td>否</td>
<td>联系方式</td>
<td>string</td>
<td>18977687686</td>
</tr>
<tr>
<td>address</td>
<td>否</td>
<td>否</td>
<td>收货地址</td>
<td>string</td>
<td>大学城</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>杨总</td>
</tr>
<tr>
<td>out_order_no</td>
<td>否</td>
<td>否</td>
<td>外部单号</td>
<td>string</td>
<td>jojdojfo903u40jgi</td>
</tr>
<tr>
<td>sell_date</td>
<td>是</td>
<td>否</td>
<td>销售时间</td>
<td>date</td>
<td>2021-11-01 20:20:20</td>
</tr>
<tr>
<td>is_draft</td>
<td>是</td>
<td>否</td>
<td>是否草稿：1-是 0-否</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>proof_image</td>
<td>否</td>
<td>否</td>
<td>凭证图片(多图逗号分隔)</td>
<td>string</td>
<td>./kkkk.png</td>
</tr>
<tr>
<td>real_money</td>
<td>否</td>
<td>否</td>
<td>实收金额（实际入账）</td>
<td>string</td>
<td>10.99</td>
</tr>
<tr>
<td>source</td>
<td>否</td>
<td>否</td>
<td>订单来源</td>
<td>integer</td>
<td>订单来源:0-未知 1-安卓 2-ios 3-pc 4-微信小程序 5-抖音小程序</td>
</tr>
</tbody>
</table>
<blockquote>
<p>goods_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>materiel_type_id</td>
<td>是</td>
<td>否</td>
<td>商品关联id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>name</td>
<td>是</td>
<td>否</td>
<td>商品名称</td>
<td>string</td>
<td>笔记本</td>
</tr>
<tr>
<td>type_name</td>
<td>是</td>
<td>否</td>
<td>规格</td>
<td>string</td>
<td>Mac</td>
</tr>
<tr>
<td>materiel_no</td>
<td>否</td>
<td>否</td>
<td>编号</td>
<td>string</td>
<td>452342345</td>
</tr>
<tr>
<td>price</td>
<td>是</td>
<td>否</td>
<td>价格</td>
<td>string</td>
<td>3</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>image</td>
<td>否</td>
<td>否</td>
<td>商品图片</td>
<td>string</td>
<td>kk.png</td>
</tr>
<tr>
<td>warehouse</td>
<td>是</td>
<td>否</td>
<td>仓库名称</td>
<td>string</td>
<td>一仓</td>
</tr>
<tr>
<td>warehouse_id</td>
<td>是</td>
<td>否</td>
<td>仓库主键id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>shelf_id</td>
<td>是</td>
<td>否</td>
<td>货架id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>location_id</td>
<td>是</td>
<td>否</td>
<td>库位id</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>package_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>price</td>
<td>是</td>
<td>否</td>
<td>价格</td>
<td>string</td>
<td>3</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>package_id</td>
<td>是</td>
<td>否</td>
<td>套餐id;默认为0，非0时表示该销售单添加的是套餐内容</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>package_content</td>
<td>是</td>
<td>否</td>
<td>仓库主键id</td>
<td>array</td>
<td>套餐内容</td>
</tr>
</tbody>
</table>
<blockquote>
<p>package_content</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>套餐内容id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>materiel_type_id</td>
<td>是</td>
<td>否</td>
<td>商品id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>materiel_class_id</td>
<td>是</td>
<td>否</td>
<td>商品二级分类id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>storage_id</td>
<td>是</td>
<td>否</td>
<td>出库仓库id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>storage_manage_id</td>
<td>是</td>
<td>否</td>
<td>商品库存id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>shelf_id</td>
<td>是</td>
<td>否</td>
<td>货架id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>location_id</td>
<td>是</td>
<td>否</td>
<td>库位id</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: 32      销售单主键id
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-08-25 16:40`:请求参数 增加`shelf_id`,`location_id`
</code></pre></blockquote>
<h2 id="-">编辑</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>编辑销售单</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/sell_edit</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注</p>
<pre><code>修改时，套餐的数据中，`materiel_type_id`为必填，默认为0
</code></pre></blockquote>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>销售主键id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>customer_name</td>
<td>否</td>
<td>否</td>
<td>客户姓名</td>
<td>string</td>
<td>杨总</td>
</tr>
<tr>
<td>goods_info</td>
<td>否</td>
<td>否</td>
<td>商品信息</td>
<td>array</td>
<td>[{&quot;materiel_type_id&quot;:35069,&quot;name&quot;:&quot;测试1&quot;,&quot;type_name&quot;:&quot;型号1&quot;,&quot;materiel_no&quot;:&quot;ol1Tpi3Y&quot;,&quot;price&quot;:&quot;10&quot;,&quot;num&quot;:&quot;100&quot;,&quot;image&quot;:&quot;&quot;,&quot;warehouse&quot;:&quot;shop1&quot;,&quot;warehouse_id&quot;:1872,&quot;shelf_id&quot;:1613,&quot;location_id&quot;:1614}]</td>
</tr>
<tr>
<td>package_info</td>
<td>否</td>
<td>否</td>
<td>套餐信息</td>
<td>array</td>
<td>[{&quot;price&quot;:&quot;1&quot;,&quot;num&quot;:&quot;2&quot;,&quot;package_id&quot;:511,&quot;name&quot;:&quot;新套餐2&quot;,&quot;package_content&quot;:[{&quot;allName&quot;:&quot;测试1/型号1(ol1Tpi3Y)&quot;,&quot;id&quot;:362,&quot;materiel_type_id&quot;:35069,&quot;num&quot;:&quot;5&quot;,&quot;materiel_class_id&quot;:10367,&quot;storage_id&quot;:1872,&quot;storage_manage_id&quot;:29,&quot;shelf_id&quot;:1613,&quot;location_id&quot;:1614},{&quot;allName&quot;:&quot;测试2/型号2(00JvmCY9)&quot;,&quot;id&quot;:363,&quot;materiel_type_id&quot;:35070,&quot;num&quot;:&quot;50&quot;,&quot;materiel_class_id&quot;:10367,&quot;storage_id&quot;:1872,&quot;storage_manage_id&quot;:32,&quot;shelf_id&quot;:1613,&quot;location_id&quot;:1614}]}]</td>
</tr>
<tr>
<td>discount</td>
<td>否</td>
<td>否</td>
<td>折扣 ：百分比</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>tax_rate</td>
<td>否</td>
<td>否</td>
<td>税率 ：百分比</td>
<td>integer</td>
<td>13</td>
</tr>
<tr>
<td>is_zero_suppression</td>
<td>是</td>
<td>否</td>
<td>是否抹零：0-否 1-是</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>final_money</td>
<td>否</td>
<td>否</td>
<td>实际应收金额（即折扣或抹零后价格）如果是抹零此参数必传</td>
<td>string</td>
<td>10.99</td>
</tr>
<tr>
<td>deliver_goods_type</td>
<td>否</td>
<td>否</td>
<td>发货方式：1-自提 2-代发 3-送货</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>transport_type</td>
<td>否</td>
<td>否</td>
<td>运输方式：1-空运 2-海运 3-铁路 4-公路</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>consignee</td>
<td>否</td>
<td>否</td>
<td>收货人</td>
<td>string</td>
<td>孙先生</td>
</tr>
<tr>
<td>phone</td>
<td>否</td>
<td>否</td>
<td>联系方式</td>
<td>string</td>
<td>18977687686</td>
</tr>
<tr>
<td>address</td>
<td>否</td>
<td>否</td>
<td>收货地址</td>
<td>string</td>
<td>大学城</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>杨总</td>
</tr>
<tr>
<td>out_order_no</td>
<td>否</td>
<td>否</td>
<td>外部单号</td>
<td>string</td>
<td>jojdojfo903u40jgi</td>
</tr>
<tr>
<td>sell_date</td>
<td>是</td>
<td>否</td>
<td>销售时间</td>
<td>date</td>
<td>2021-11-01 20:20:20</td>
</tr>
<tr>
<td>is_draft</td>
<td>是</td>
<td>否</td>
<td>是否草稿：1-是 0-否</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>proof_image</td>
<td>否</td>
<td>否</td>
<td>凭证图片(多图逗号分隔)</td>
<td>string</td>
<td>./kkkk.png</td>
</tr>
<tr>
<td>real_money</td>
<td>否</td>
<td>否</td>
<td>实收金额（实际入账）</td>
<td>string</td>
<td>22.90</td>
</tr>
<tr>
<td>logistics_company</td>
<td>否</td>
<td>否</td>
<td>物流公司</td>
<td>string</td>
<td>中通</td>
</tr>
<tr>
<td>logistics_order_no</td>
<td>否</td>
<td>否</td>
<td>物流单号</td>
<td>string</td>
<td>asdfadsu493f9f</td>
</tr>
<tr>
<td>order_time</td>
<td>否</td>
<td>否</td>
<td>下单时间</td>
<td>date</td>
<td>2021-11-01 20:20:20</td>
</tr>
<tr>
<td>deliver_time</td>
<td>否</td>
<td>否</td>
<td>发货时间</td>
<td>date</td>
<td>2021-11-01 20:20:20</td>
</tr>
<tr>
<td>deliver_person</td>
<td>否</td>
<td>否</td>
<td>发货人</td>
<td>string</td>
<td>孙总</td>
</tr>
<tr>
<td>deliver_phone</td>
<td>否</td>
<td>否</td>
<td>发货人联系方式</td>
<td>string</td>
<td>14289877837</td>
</tr>
<tr>
<td>deliver_addr</td>
<td>否</td>
<td>否</td>
<td>发货地址</td>
<td>string</td>
<td>东海大道</td>
</tr>
<tr>
<td>source</td>
<td>否</td>
<td>否</td>
<td>订单来源</td>
<td>integer</td>
<td>订单来源:0-未知 1-安卓 2-ios 3-pc 4-微信小程序 5-抖音小程序</td>
</tr>
<tr>
<td>total_piece</td>
<td>否</td>
<td>否</td>
<td>商品总件数</td>
<td>integer</td>
<td>11</td>
</tr>
<tr>
<td>driver</td>
<td>否</td>
<td>否</td>
<td>司机信息</td>
<td>obj</td>
<td>{&quot;plate_number&quot;:&quot;皖*98098&quot;,&quot;name&quot;:&quot;测试&quot;,&quot;phone&quot;:&quot;18966558879&quot;,&quot;logistics_company&quot;:&quot;&quot;,&quot;remark&quot;:&quot;&quot;,&quot;plate_image&quot;:&quot;k.png&quot;,&quot;id_card_image&quot;:&quot;ks.png&quot;,&quot;driving_licence&quot;:&quot;kks.png&quot;}</td>
</tr>
</tbody>
</table>
<blockquote>
<p>goods_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>materiel_type_id</td>
<td>是</td>
<td>否</td>
<td>商品关联id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>name</td>
<td>是</td>
<td>否</td>
<td>商品名称</td>
<td>string</td>
<td>笔记本</td>
</tr>
<tr>
<td>type_name</td>
<td>是</td>
<td>否</td>
<td>规格</td>
<td>string</td>
<td>Mac</td>
</tr>
<tr>
<td>materiel_no</td>
<td>否</td>
<td>否</td>
<td>编号</td>
<td>string</td>
<td>452342345</td>
</tr>
<tr>
<td>price</td>
<td>是</td>
<td>否</td>
<td>价格</td>
<td>string</td>
<td>3</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>image</td>
<td>否</td>
<td>否</td>
<td>商品图片</td>
<td>string</td>
<td>kk.png</td>
</tr>
<tr>
<td>warehouse</td>
<td>是</td>
<td>否</td>
<td>仓库名称</td>
<td>string</td>
<td>一仓</td>
</tr>
<tr>
<td>warehouse_id</td>
<td>是</td>
<td>否</td>
<td>仓库主键id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>shelf_id</td>
<td>是</td>
<td>否</td>
<td>货架id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>location_id</td>
<td>是</td>
<td>否</td>
<td>库位id</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>package_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>price</td>
<td>是</td>
<td>否</td>
<td>价格</td>
<td>string</td>
<td>3</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>piece</td>
<td>否</td>
<td>否</td>
<td>件数</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>package_id</td>
<td>是</td>
<td>否</td>
<td>套餐id;默认为0，非0时表示该销售单添加的是套餐内容</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>package_content</td>
<td>是</td>
<td>否</td>
<td>仓库主键id</td>
<td>array</td>
<td>套餐内容</td>
</tr>
<tr>
<td>shelf_id</td>
<td>是</td>
<td>否</td>
<td>货架id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>location_id</td>
<td>是</td>
<td>否</td>
<td>库位id</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>package_content</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>套餐内容id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>type_id</td>
<td>是</td>
<td>否</td>
<td>商品id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>materiel_class_id</td>
<td>是</td>
<td>否</td>
<td>商品二级分类id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>storage_id</td>
<td>是</td>
<td>否</td>
<td>出库仓库id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>storage_manage_id</td>
<td>是</td>
<td>否</td>
<td>商品库存id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>shelf_id</td>
<td>是</td>
<td>否</td>
<td>货架id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>location_id</td>
<td>是</td>
<td>否</td>
<td>库位id</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注</p>
<pre><code>修改套餐至销售单时，`package_id`不能为0，且`package_content`不能为空，`package_content`中`num`可以自由编辑；
修改商品至销售单时，`package_id`必须为0，且`package_content`为0
</code></pre></blockquote>
<blockquote>
<p>变动内容</p>
<pre><code>`2022-08-25 16:40`:请求参数 增加`shelf_id`,`location_id`
</code></pre></blockquote>
<h2 id="-">出库</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>销售单出库</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/sell_out</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>销售单主键id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>status</td>
<td>是</td>
<td>否</td>
<td>出入库状态：0-部分 1-全部</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>goods_info</td>
<td>否（全部是不传）</td>
<td>否</td>
<td>商品信息</td>
<td>array</td>
<td></td>
</tr>
<tr>
<td>package_info</td>
<td>否（全部是不传）</td>
<td>否</td>
<td>套餐信息</td>
<td>array</td>
<td></td>
</tr>
<tr>
<td>in_storage_time</td>
<td>是</td>
<td>否</td>
<td>出库时间</td>
<td>date</td>
<td>2021-09-09 20:20:11</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>备注</td>
</tr>
</tbody>
</table>
<blockquote>
<p>goods_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>materiel_type_id</td>
<td>是</td>
<td>否</td>
<td>商品关联id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>price</td>
<td>是</td>
<td>否</td>
<td>价格</td>
<td>string</td>
<td>3</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>warehouse_id</td>
<td>是</td>
<td>否</td>
<td>仓库主键id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>package_id</td>
<td>是</td>
<td>否</td>
<td>套餐id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>batch_info</td>
<td>是</td>
<td>否</td>
<td>批次信息，默认为空数组</td>
<td>array</td>
<td>1</td>
</tr>
<tr>
<td>shelf_id</td>
<td>是</td>
<td>否</td>
<td>货架id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>location_id</td>
<td>是</td>
<td>否</td>
<td>库位id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>serial_no</td>
<td>是</td>
<td>否</td>
<td>序列号</td>
<td>string</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>package_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>price</td>
<td>是</td>
<td>否</td>
<td>价格</td>
<td>string</td>
<td>3</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>package_id</td>
<td>是</td>
<td>否</td>
<td>套餐id</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>备注</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>package_content</td>
<td>是</td>
<td>否</td>
<td>销售单套餐内商品信息</td>
<td>array</td>
<td></td>
</tr>
</tbody>
</table>
<blockquote>
<p>package_content</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>package_content_id</td>
<td>是</td>
<td>否</td>
<td>销售单套餐内商品id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>销售单套餐内商品id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>batch_info</td>
<td>是</td>
<td>否</td>
<td>批次信息，默认为空数组</td>
<td>array</td>
<td>1</td>
</tr>
<tr>
<td>serial_no</td>
<td>是</td>
<td>否</td>
<td>序列号</td>
<td>string</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>batch_info</code></p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>batch_id</td>
<td>是</td>
<td>否</td>
<td>批次主键id</td>
<td>string</td>
<td>3</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>storage_manage_id</td>
<td>是</td>
<td>否</td>
<td>库存id</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>备注</p>
<pre><code>设置中如果开启使用批次号出库，则`batch_info`为必填项
</code></pre></blockquote>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-09-3 16:40`:请求参数 增加`goods_info`和`package_content` 增加`serial_no` 序列号参数
`2022-08-25 16:40`:请求参数 增加`shelf_id`,`location_id`
</code></pre></blockquote>
<h1 id="-zl-">直接出库-批量(zl)</h1>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>直接入库</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/direct_out_storage_several</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>goods_info</td>
<td>是</td>
<td>否</td>
<td>商品信息</td>
<td>json</td>
<td>[{&quot;storageManageId&quot;:32,&quot;num&quot;:&quot;1&quot;,&quot;price&quot;:3,&quot;serial_no&quot;:&quot;sj0002&quot;,&quot;batch_info&quot;:[{&quot;batch_id&quot;:289,&quot;num&quot;:&quot;1.000000&quot;,&quot;storage_manage_id&quot;:136}]},{&quot;storageManageId&quot;:29,&quot;num&quot;:&quot;1&quot;,&quot;price&quot;:3,&quot;serial_no&quot;:&quot;sj0001&quot;,&quot;batch_info&quot;:[{&quot;batch_id&quot;:289,&quot;num&quot;:&quot;1.000000&quot;,&quot;storage_manage_id&quot;:136}]}]</td>
</tr>
<tr>
<td>package_info</td>
<td>是</td>
<td>否</td>
<td>套餐信息</td>
<td>json</td>
<td>[{&quot;package_id&quot;:511,&quot;price&quot;:&quot;1&quot;,&quot;num&quot;:5,&quot;remark&quot;:&quot;&quot;,&quot;package_content&quot;:[{&quot;package_content_id&quot;:362,&quot;num&quot;:&quot;5&quot;,&quot;serial_no&quot;:&quot;sj0002&quot;,&quot;batch_info&quot;:[{&quot;batch_id&quot;:289,&quot;num&quot;:&quot;1.000000&quot;,&quot;storage_manage_id&quot;:136}]},{&quot;package_content_id&quot;:363,&quot;num&quot;:&quot;50&quot;,&quot;serial_no&quot;:&quot;sj0002&quot;,&quot;batch_info&quot;:[{&quot;batch_id&quot;:289,&quot;num&quot;:&quot;1.000000&quot;,&quot;storage_manage_id&quot;:136}]}]}]</td>
</tr>
</tbody>
</table>
<blockquote>
<p>goods_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>storageManageId</td>
<td>是</td>
<td>否</td>
<td>库存id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>price</td>
<td>是</td>
<td>否</td>
<td>价格</td>
<td>string</td>
<td>3</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>serial_no</td>
<td>否</td>
<td>否</td>
<td>序列号（开启必传）</td>
<td>string</td>
<td>10</td>
</tr>
<tr>
<td>shelf_id</td>
<td>是</td>
<td>否</td>
<td>货架ID</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>location_id</td>
<td>是</td>
<td>否</td>
<td>库位ID</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>package_info</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>package_id</td>
<td>是</td>
<td>否</td>
<td>套餐id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>price</td>
<td>是</td>
<td>否</td>
<td>价格</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>package_content</td>
<td>是</td>
<td>否</td>
<td>套餐名称</td>
<td>array</td>
<td>套餐内容</td>
</tr>
<tr>
<td>remark</td>
<td>是</td>
<td>否</td>
<td>备注</td>
<td>string</td>
<td>备注</td>
</tr>
<tr>
<td>serial_no</td>
<td>否</td>
<td>否</td>
<td>序列号（开启必传）</td>
<td>string</td>
<td>10</td>
</tr>
<tr>
<td>shelf_id</td>
<td>是</td>
<td>否</td>
<td>货架ID</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>location_id</td>
<td>是</td>
<td>否</td>
<td>库位ID</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>package_content</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>package_content_id</td>
<td>是</td>
<td>否</td>
<td>套餐内容id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>1</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>batch_info</code></p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>batch_id</td>
<td>是</td>
<td>否</td>
<td>批次主键id</td>
<td>string</td>
<td>3</td>
</tr>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>3</td>
</tr>
<tr>
<td>storage_manage_id</td>
<td>是</td>
<td>否</td>
<td>库存id</td>
<td>integer</td>
<td>10</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-09-29 14:48`:请求参数 增加`serial_no`和`batch_info`
</code></pre></blockquote>
<h1 id="-zlf-">一键清除（zlf）</h1>
<h2 id="-">一键清除</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>一键清除</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/one_key_clear</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>clear_storage</td>
<td>是</td>
<td>否</td>
<td>是否清除库存;0:否;1:是;</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>clear_materiel</td>
<td>是</td>
<td>否</td>
<td>是否清除商品;0:否;1:是;</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>clear_class</td>
<td>是</td>
<td>否</td>
<td>是否清除分类否;0:否;1:是;</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>code</td>
<td>是</td>
<td>否</td>
<td>验证码</td>
<td>integer</td>
<td>123456</td>
</tr>
<tr>
<td>mobile</td>
<td>是</td>
<td>否</td>
<td>主账号手机号</td>
<td>integer</td>
<td>17688888888</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre><blockquote>
<p>变动内容</p>
<pre><code>`2022-09-23 11:27`:请求参数 增加`code`和`mobile`
</code></pre></blockquote>
<h2 id="-">查询主账号手机号</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>查询主账号手机号</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/get_main_phone</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td></td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;:{
        &quot;mobile&quot;: &quot;17688888888&quot;
    }
}
</code></pre><h2 id="-">一键清除发送验证码</h2>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>发送验证码</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/get_one_clear_code</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>mobile</td>
<td>是</td>
<td>否</td>
<td>主账号手机号</td>
<td>integer</td>
<td>17688888888</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;验证码已成功发送，请注意查收&quot;,
    &quot;data&quot;:&quot;&quot;
}
</code></pre><h1 id="-zlf-">出入库列表（zlf）</h1>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>操作记录-操作记录列表</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/storage_log_list</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>出入库及套餐操作记录</code>公共请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>pageSize</td>
<td>是</td>
<td>否</td>
<td>页面大小</td>
<td>integer</td>
<td>10</td>
</tr>
<tr>
<td>currentPage</td>
<td>是</td>
<td>否</td>
<td>当前页</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>type</td>
<td>是</td>
<td>否</td>
<td>操作日志类型;0:入库;1:出库;2:套餐出库;</td>
<td>integer</td>
<td>0</td>
</tr>
<tr>
<td>keyword</td>
<td>否</td>
<td>否</td>
<td>操作记录主键id</td>
<td>string</td>
<td>牛卫士洗衣凝珠</td>
</tr>
<tr>
<td>start_time</td>
<td>否</td>
<td>否</td>
<td>起始时间</td>
<td>date</td>
<td>牛卫士洗衣凝珠</td>
</tr>
<tr>
<td>end_time</td>
<td>否</td>
<td>否</td>
<td>结束时间</td>
<td>date</td>
<td>牛卫士洗衣凝珠</td>
</tr>
<tr>
<td>status</td>
<td>否</td>
<td>否</td>
<td>撤销状态(0:未撤销;1:已撤销;)</td>
<td>integer</td>
<td>牛卫士洗衣凝珠</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>出入库操作记录</code> 独立请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>materiel_class_id</td>
<td>是</td>
<td>否</td>
<td>物料二级分类id，默认为0</td>
<td>integer</td>
<td>0</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>入库操作记录</code>数据返回</p>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        ......
        &quot;type&quot;: 0,  //    日志类型;0:入库;1:调拨入库;2:直接入库;
        &quot;in_storage_time&quot;: &quot;2021-11-13 13:14:15&quot;,   //入库时间-`入库`时返回
        &quot;purchase_no&quot;: &quot;20211228135710792267486&quot;,    //采购单号
        &quot;last_storage_name&quot;: &quot;&quot;,    //调入前所在仓库名称
        &quot;last_storage_address&quot;: &quot;&quot;,     //调入前所在仓库地址    
         &quot;location_name&quot;: &quot;默认库位&quot;,//库位名称
        &quot;shelf_name&quot;: &quot;默认库位&quot;,//货架名称
        &quot;serial_number&quot;:  [
            &quot;88888&quot;,
            &quot;99999&quot;,
            &quot;1111&quot;
        ]//序列号
        ......
    }
}
</code></pre><p><code>出库操作记录</code>数据返回</p>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        ......
        &quot;type&quot;: 0,  //type;0:出库;1:调出;2:直接出库;
        &quot;out_storage_time&quot;: &quot;2021-11-13 13:14:15&quot;,   //出库时间-`出库`时返回
        &quot;next_storage_name&quot;: &quot;&quot;,    //调入后所在仓库名称    
        &quot;next_storage_address&quot;: &quot;&quot;,     //调入后所在仓库地址    
         &quot;location_name&quot;: &quot;默认库位&quot;,//库位名称
                &quot;shelf_name&quot;: &quot;默认库位&quot;,//货架名称
                &quot;serial_number&quot;:  [
                    &quot;88888&quot;,
                    &quot;99999&quot;,
                    &quot;1111&quot;
                ]//序列号
        ......
    }
}
</code></pre></blockquote>
<blockquote>
<p><code>出入库操作记录</code>公共数据返回</p>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
            {
                &quot;id&quot;: 1,    //日志主键id
                &quot;storage_name&quot;: &quot;蚌埠掌上网络科技有限公司&quot;, //物料当前所在仓库名
                &quot;storage_address&quot;: &quot;B2-6&quot;,  //物料当前所在仓库地址
                &quot;materiel_class_name&quot;: &quot;面膜&quot;,    //物料二级分类名称
                &quot;materiel_class_no&quot;: &quot;&quot;,    //物料二级分类编号
                &quot;materiel_name&quot;: &quot;时尚烟酰胺亮颜保湿面膜&quot;, //物料名称
                &quot;type_name&quot;: &quot;保湿&quot;,  //物料型号
                &quot;materiel_no&quot;: &quot;&quot;,  //物料编号
                &quot;operate_num&quot;: 100, //操作数量
                &quot;last_storage_num&quot;: 0,  //操作前库存数
                &quot;next_storage_num&quot;: 100,    //操作后库存数
                &quot;materiel_mean_cost&quot;: &quot;0.00&quot;,   //物料均价    
                &quot;remark&quot;: &quot;&quot;,   //备注
                &quot;is_cancel&quot;: 0,     //    是否撤销;0:否;1:是;
                &quot;first_class_id&quot;: 3,    //物料一级分类id
                &quot;class_name&quot;: &quot;美妆用品&quot;,   //物料二级分类名称
                &quot;class_no&quot;: &quot;&quot;,  //物料二级分类编号
                &quot;username&quot;: &quot;掌上仓管&quot;,     //操作人账号名
                &quot;nickname&quot;: &quot;施艳梅&quot;,   //操作人昵称
                 &quot;location_name&quot;: &quot;默认库位&quot;,//库位名称
                &quot;shelf_name&quot;: &quot;默认库位&quot;,//货架名称
                &quot;serial_number&quot;:  [
                    &quot;88888&quot;,
                    &quot;99999&quot;,
                    &quot;1111&quot;
                ]//序列号
            },
            ......
        ],
        &quot;total&quot;: 8 //总条数
    }
}
</code></pre></blockquote>
<blockquote>
<p><code>套餐出库操作记录</code>数据返回</p>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: {
        &quot;current_page&quot;: 1,
        &quot;data&quot;: [
            {
                &quot;id&quot;: 2,    //套餐出库日志主键id
                &quot;package_name&quot;: &quot;+测试2&quot;, //套餐名
                &quot;num&quot;: 1,   //操作数量
                &quot;remark&quot;: &quot;123123321&quot;,  //备注
                &quot;is_cancel&quot;: 0,//是否撤销;0:否;1:是;
                &quot;created_at&quot;: &quot;2021-12-03 15:28:42&quot;,    //出库时间
                &quot;username&quot;: &quot;掌上仓管&quot;, //操作人账户名
                &quot;nickname&quot;: &quot;施艳梅&quot;   //操作人昵称
                &quot;location_name&quot;: &quot;默认库位&quot;,//库位名称
                &quot;shelf_name&quot;: &quot;默认库位&quot;,//货架名称
                &quot;serial_number&quot;:  [
                    &quot;88888&quot;,
                    &quot;99999&quot;,
                    &quot;1111&quot;
                ]//序列号
            }
        ],
        &quot;total&quot;: 2  //总条目数
    }
}
</code></pre><p>变动内容</p>
<pre><code>`2022-09-24 10:29`:返回参数 增加`location_name`、`shelf_name`、`serial_number`
</code></pre></blockquote>
<h1 id="-">库存直接入库</h1>
<blockquote>
<p>接口信息</p>
</blockquote>
<table>
<thead>
<tr>
<th>接口描述</th>
<th>协议</th>
<th>请求方式</th>
<th>请求地址</th>
<th>数据返回格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>库存直接入库</td>
<td>http</td>
<td>post</td>
<td>v3.1/api/storage_manage_in</td>
<td>json</td>
</tr>
</tbody>
</table>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>参数</th>
<th>是否必传</th>
<th>可否为空</th>
<th>说明</th>
<th>类型</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>num</td>
<td>是</td>
<td>否</td>
<td>数量</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>id</td>
<td>是</td>
<td>否</td>
<td>库存id</td>
<td>integer</td>
<td>1</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>否</td>
<td>是否清除分类否;0:否;1:是;</td>
<td>string</td>
<td>库存直接入库</td>
</tr>
</tbody>
</table>
<blockquote>
<p>数据返回</p>
</blockquote>
<pre><code>{
    &quot;code&quot;: 0,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;: &quot;&quot;
}
</code></pre>
          	</article>
        </div>
		</div>
  </body>
</html>
<script type="text/javascript" src="toc/js/jquery-1.4.4.min.js"></script>
<script type="text/javascript" src="toc/js/jquery.ztree.all-3.5.min.js"></script>
<script type="text/javascript" src="toc/js/ztree_toc.js"></script>
<script type="text/javascript" src="toc_conf.js"></script>

<SCRIPT type="text/javascript" >
<!--
$(document).ready(function(){
    var css_conf = eval(markdown_panel_style);
    $('#readme').css(css_conf)
    
    var conf = eval(jquery_ztree_toc_opts);
		$('#tree').ztree_toc(conf);
});
//-->
</SCRIPT>